lightfall-mcp-bridge

MCP server that bridges Claude Code to running Lightfall beamline control instances via NATS.

What it does

Provides three MCP tools:

  • list_instances — Discover Lightfall instances on the NATS bus
  • list_actions — Get available actions from a specific instance
  • execute_action — Invoke an action (run plans, abort, query state, etc.)

Actions are discovered dynamically — the bridge never needs updating when Lightfall adds new capabilities.

Installation

pip install -e .

Configuration

Add to your Claude Code MCP config (.mcp.json or settings):

{
  "lightfall": {
    "command": "python",
    "args": ["-m", "lightfall_bridge", "--nats-url", "nats://localhost:4222"]
  }
}

Optional: --default-prefix als.7011 to set a default Lightfall instance.

Requirements

  • A running NATS server (local or remote)
  • A running Lightfall instance with IPC enabled

Development

python -m venv .venv
.venv/Scripts/activate  # or source .venv/bin/activate on Unix
pip install -e ".[dev]"
pytest

Integration tests require a NATS server at localhost:4222 and are skipped otherwise.

Project links

Data verified by PyPI on Aug 11, 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:
Latest release

1 maintainer

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

Credits

Author: ALS Controls Team

GitHub Statistics

Data verified by PyPI on Aug 11, 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

BSD-3-Clause
View SPDX License List

Requires

Python >=3.10

Provides Extra

dev

Tags

beamline control-system lightfall mcp nats

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

lightfall_mcp_bridge-0.1.0.tar.gz (9.7 kB view details)

Uploaded Source

Built Distribution

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

lightfall_mcp_bridge-0.1.0-py3-none-any.whl (7.5 kB view details)

Uploaded Python 3

File details

Details for the file lightfall_mcp_bridge-0.1.0.tar.gz.

File metadata

  • Download URL: lightfall_mcp_bridge-0.1.0.tar.gz
  • Upload date:
  • Size: 9.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for lightfall_mcp_bridge-0.1.0.tar.gz
Algorithm Hash digest
SHA256 af4c6e82f0b4089a8d4f20eddcd9d118a4c54ce0db663f168dcfafb6da0eeb7c
MD5 f2c74cad004c676fa370addc40cfc77c
BLAKE2b-256 2a3d9ab1f0ed739d8cb0ffec4f10a9316d355b9ecb26c3550441fa3a226341a2

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightfall_mcp_bridge-0.1.0.tar.gz:

Publisher: release.yml on als-controls/lightfall-mcp-bridge

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

File details

Details for the file lightfall_mcp_bridge-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for lightfall_mcp_bridge-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5c9c9c2029fb8dca2b8a185c25773a053c1c3d92a71470ffe07654f75eebb5c2
MD5 69bb5f0f376045f987e22feb1a7ff463
BLAKE2b-256 ddf6e1207eb81fd356e53eb162f6c8f90231ba7926ff636361db06fa43735a70

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightfall_mcp_bridge-0.1.0-py3-none-any.whl:

Publisher: release.yml on als-controls/lightfall-mcp-bridge

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

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page