pyMCPBroker/README.md

pyMCPBroker

Small FastAPI broker exposing three stable meta-tools over MCP backends:

• meta_tree
• meta_desc
• meta_call

Scope

Current implementation:

• MCP stdio backend only
• persistent subprocess per backend
• initialize + notifications/initialized
• paginated tools/list
• tools/call
• allow/deny wildcard filters
• backend overrides
• broker-side JSON Schema validation
• compact structured error payloads
• result truncation with shape-preserving best effort
• optional shared secret (Authorization: Bearer <secret> or X-Api-Key)

Run

pip install .
python -m pyMCPBroker 0.0.0.0:8100 /config.json

Optional shared secret:

python -m pyMCPBroker 0.0.0.0:8100 /config.json mysecret

Example config: examples/config.example.json