A MCP Forward Proxy Bridge designed to be a one-to-many bridge allowing you to use a single MCP server to communicate with many MCP servers transparently.

Navigation

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for billyjbryant from gravatar.com billyjbryant

Unverified details

These details have not been verified by PyPI
Meta
  • License: GNU Affero General Public License v3 or later (AGPLv3+) (GNU AFFERO GENERAL PUBLIC LICENSE)
  • Author: Billy Bryant
  • Requires: Python >=3.11
Classifiers
Report project as malware

Project description

MCP Foxxy Bridge

CI/CD Pipeline Release Version PyPI Version Code Coverage

Python Version License Development Status

PyPI Downloads GitHub Stars GitHub Issues GitHub Forks

pre-commit Documentation MCP Protocol Uvicorn

MCP Foxxy Bridge Logo

Overview

MCP Foxxy Bridge is a one-to-many proxy for the Model Context Protocol (MCP). It lets you aggregate and route requests to multiple MCP servers through a single endpoint, so you can:

  • Centralize configuration for all your MCP servers
  • Expose all tools, resources, and prompts from connected servers
  • Route requests transparently to the right backend
  • Use a single MCP endpoint in your AI tools (Claude Desktop, VS Code, etc.)

🚀 Quickstart

See the Installation Guide for full details.

1. Choose one of the following installation methods

A. Install via uv (Recommended):

uv tool install mcp-foxxy-bridge

B. Install latest from GitHub:

uv tool install git+https://github.com/billyjbryant/mcp-foxxy-bridge

C. Run with Docker (from GHCR):

docker run --rm -p 8080:8080 ghcr.io/billyjbryant/mcp-foxxy-bridge:latest --bridge-config /app/config.json

2. Run the Bridge

With config file:

mcp-foxxy-bridge --bridge-config config.json

Or with named servers:

mcp-foxxy-bridge --port 8080 \
  --named-server fetch 'uvx mcp-server-fetch' \
  --named-server github 'npx -y @modelcontextprotocol/server-github' \
  --named-server filesystem 'npx -y @modelcontextprotocol/server-filesystem'

See Configuration Guide for config file examples.

3. Connect Your AI Tool

Point your MCP-compatible client to:

http://localhost:8080/sse

See API Reference for integration details.

📚 Documentation

🛠️ Development

🤝 Contributing & Support

⚖️ License

This project is licensed under the GNU Affero General Public License v3.0 or later (AGPLv3+). See the LICENSE file for details.

Project details

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for billyjbryant from gravatar.com billyjbryant

Unverified details

These details have not been verified by PyPI
Meta
  • License: GNU Affero General Public License v3 or later (AGPLv3+) (GNU AFFERO GENERAL PUBLIC LICENSE)
  • Author: Billy Bryant
  • Requires: Python >=3.11
Classifiers

Release history Release notifications | RSS feed

1.7.1

1.7.0

1.6.2

1.6.1

1.6.0

1.5.0

1.4.0

1.3.1

1.3.0

1.2.0

1.1.2

This version

1.1.1

1.0.1

1.0.0

Download files

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

Source Distribution

mcp_foxxy_bridge-1.1.1.tar.gz (1.2 MB view details)

Uploaded Source

Built Distribution

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

mcp_foxxy_bridge-1.1.1-py3-none-any.whl (40.4 kB view details)

Uploaded Python 3

File details

Details for the file mcp_foxxy_bridge-1.1.1.tar.gz.

File metadata

  • Download URL: mcp_foxxy_bridge-1.1.1.tar.gz
  • Upload date:
  • Size: 1.2 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for mcp_foxxy_bridge-1.1.1.tar.gz
Algorithm Hash digest
SHA256 b3dcd71004212c379e8e770516da17e195b31043af7c0bbfbdb76edbedfcdfcf
MD5 bbf123ddd3371ef803143a15b77510c2
BLAKE2b-256 e7645185aa398eea86bcfd3e649c78f3ab16b13a02039dc3b064e3f5ac7fab83

See more details on using hashes here.

Provenance

The following attestation bundles were made for mcp_foxxy_bridge-1.1.1.tar.gz:

Publisher: main.yml on billyjbryant/mcp-foxxy-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 mcp_foxxy_bridge-1.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for mcp_foxxy_bridge-1.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 b05bbcfd07e9799113dc92338effbd9833f6e0ffc05567472abbc1725950622b
MD5 5c21dd293b5659ca4b91ea91f8c316f0
BLAKE2b-256 fd3709bc8b801086e369f0d5818f7911730f04f5630ded3f90fe946890cd2db3

See more details on using hashes here.

Provenance

The following attestation bundles were made for mcp_foxxy_bridge-1.1.1-py3-none-any.whl:

Publisher: main.yml on billyjbryant/mcp-foxxy-bridge

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

Supported by

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