LightNow Local Proxy

PyPI

The LightNow Local Proxy lets local MCP clients use one LightNow-managed MCP entry instead of storing every MCP server configuration and secret in every client.

It runs on your machine, uses your LightNow CLI login session, resolves the MCP servers enabled for your selected LightNow profile, and forwards tool/resource requests to local stdio or reachable Streamable HTTP MCP servers.

Install

Requirements:

pipx install lightnow-cli
lightnow login

Install the proxy with Homebrew:

brew tap lightnow-ai/tap
brew install lightnow-proxy

Or install it with pipx:

pipx install lightnow-proxy

Or install it with uv:

uv tool install lightnow-proxy

The Python package installs the lightnow-proxy command used by MCP clients.

For repository-local development:

uv tool install --from . lightnow-proxy

Configure a Client

Use the LightNow CLI. It writes the client MCP entry and the per-client Local Proxy config.

lightnow sync --client codex --local-proxy
lightnow sync --client claude-desktop --local-proxy
lightnow sync --client cursor --local-proxy
lightnow sync --client vscode --local-proxy
lightnow sync --client antigravity --local-proxy

Restart the MCP client after syncing.

Check the local setup:

lightnow config-status --client codex

Check whether the proxy can resolve the selected profile and reach its upstream MCP servers:

lightnow-proxy --config ~/.lightnow/lightnow-proxy/codex.yaml --health
lightnow-proxy --config ~/.lightnow/lightnow-proxy/codex.yaml --health --json

When telemetry is enabled, active health checks are also sent to LightNow Insights as metadata-only proxy health events. The Insights page can then show which clients and profiles are healthy, degraded, or failing without storing secrets, tool arguments, or response bodies.

More Documentation

Detailed setup guides, examples, diagrams, supported client paths, telemetry behavior and troubleshooting live in the LightNow docs:

Local Development

For contributors working on this repository:

uv venv
uv pip install -e .[dev]
make test

Run the proxy with the example config:

LIGHTNOW_PROXY_CONFIG=config.example.yaml uv run lightnow-proxy

Run the proxy as a stdio MCP server:

uv run lightnow-proxy --config config.example.yaml --transport stdio

Run a local health check against the example config:

uv run lightnow-proxy --config config.example.yaml --health

Project links

Data verified by PyPI on Jul 6, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.9.1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for apitree from gravatar.com apitree

Credits

Author: LightNow Engineering

GitHub Statistics

Data verified by PyPI on Jul 6, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

Apache-2.0
View SPDX License List

Requires

Python >=3.11

Provides Extra

dev

Tags

lightnow mcp model-context-protocol local-proxy proxy

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

lightnow_proxy-1.2.0.tar.gz (42.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

lightnow_proxy-1.2.0-py3-none-any.whl (32.4 kB view details)

Uploaded Python 3

File details

Details for the file lightnow_proxy-1.2.0.tar.gz.

File metadata

  • Download URL: lightnow_proxy-1.2.0.tar.gz
  • Upload date:
  • Size: 42.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for lightnow_proxy-1.2.0.tar.gz
Algorithm Hash digest
SHA256 7316e11b384e86b050fa774dbad2d69310c7249387cb724125b61d6a8596629d
MD5 2c6f7e7a1fbbb67a14b49651faf17dc1
BLAKE2b-256 91c43800c9202f10e5f0707dea68d60dd8151beb4aee2dd6c9340bdde0cb6c56

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightnow_proxy-1.2.0.tar.gz:

Publisher: release.yml on lightnow-ai/lightnow-proxy

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file lightnow_proxy-1.2.0-py3-none-any.whl.

File metadata

  • Download URL: lightnow_proxy-1.2.0-py3-none-any.whl
  • Upload date:
  • Size: 32.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for lightnow_proxy-1.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 37ce1f43812365637762a49364973072ec3e6c86faee017200b5fb896e4c27e8
MD5 752d95065831e2ae15d31b786dfb026d
BLAKE2b-256 ff999e9b378107804c3d088743c307aa3c642d30252b0ca72e3d94265832a6dd

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightnow_proxy-1.2.0-py3-none-any.whl:

Publisher: release.yml on lightnow-ai/lightnow-proxy

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

1.9.1

2 files

1.9.0

2 files

1.8.0

2 files

1.7.1

2 files

1.7.0

2 files

1.6.0

2 files

1.5.0

2 files

1.4.2

2 files

1.4.1

2 files

1.4.0

2 files

1.3.0

2 files

This release

1.2.0 This release

2 files

1.1.0

2 files

1.0.1

2 files

1.0.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page