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.
Project description
MCP Foxxy Bridge
Overview
MCP Foxxy Bridge is a secure one-to-many proxy for the Model Context Protocol (MCP). Connect multiple MCP servers through a single endpoint with enterprise-grade security.
Key Features:
- Single endpoint for all MCP servers
- OAuth 2.0 + PKCE authentication
- Enhanced CLI with daemon management
- REST API for operational control
- Secure command substitution
- HTTP/2 support
Quickstart
Installation
# Install via uv (recommended)
uv tool install mcp-foxxy-bridge
# Or install from GitHub
uv tool install git+https://github.com/billyjbryant/mcp-foxxy-bridge
Quick Setup
# Initialize configuration
foxxy-bridge config init
# Add MCP servers
foxxy-bridge mcp add github "npx -y @modelcontextprotocol/server-github"
foxxy-bridge mcp add filesystem "npx -y @modelcontextprotocol/server-filesystem" --path ./
# Start the bridge server
foxxy-bridge server start
# Check status
foxxy-bridge server status
Connect Your AI Tool
Point your MCP-compatible client to: http://localhost:8080/sse
Documentation
📖 Getting Started:
- Installation Guide - Detailed setup and configuration
- Configuration Guide - Configuration options and examples
- CLI Reference - Complete command reference
🔧 Advanced Topics:
- API Reference - REST API endpoints
- OAuth Authentication - OAuth setup and security
- Daemon Management - Background process management
- Troubleshooting - Common issues and solutions
Contributing & Support
License
AGPL-3.0-or-later - See LICENSE file for details.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mcp_foxxy_bridge-1.6.2.tar.gz.
File metadata
- Download URL: mcp_foxxy_bridge-1.6.2.tar.gz
- Upload date:
- Size: 1.5 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e4c01d4038cb7f9a8c1c585cc9954b7f5ca8caa8eda46a0af38b596492a852ce
|
|
| MD5 |
484d5b5cede5fd13b461e1b0f719dfc5
|
|
| BLAKE2b-256 |
adc916bff127fdb63d5fc9d7ec320db7833def0beaedca755768bb6d48b07b5e
|
Provenance
The following attestation bundles were made for mcp_foxxy_bridge-1.6.2.tar.gz:
Publisher:
main.yml on billyjbryant/mcp-foxxy-bridge
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
mcp_foxxy_bridge-1.6.2.tar.gz -
Subject digest:
e4c01d4038cb7f9a8c1c585cc9954b7f5ca8caa8eda46a0af38b596492a852ce - Sigstore transparency entry: 470945660
- Sigstore integration time:
-
Permalink:
billyjbryant/mcp-foxxy-bridge@472708757ffece15cacf0649d71c3bbf4abd202e -
Branch / Tag:
refs/heads/main - Owner: https://github.com/billyjbryant
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
main.yml@472708757ffece15cacf0649d71c3bbf4abd202e -
Trigger Event:
push
-
Statement type:
File details
Details for the file mcp_foxxy_bridge-1.6.2-py3-none-any.whl.
File metadata
- Download URL: mcp_foxxy_bridge-1.6.2-py3-none-any.whl
- Upload date:
- Size: 221.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
15f2a12756cefbd580267fed14bf75ae221ba60cc615854d0c45eb3d4a3407a3
|
|
| MD5 |
d3ae13d51cdd83608009331a2e4909ee
|
|
| BLAKE2b-256 |
596b4a840bded0e794c509c824dfed4427296a97a51cfade0ce76c9635414b0c
|
Provenance
The following attestation bundles were made for mcp_foxxy_bridge-1.6.2-py3-none-any.whl:
Publisher:
main.yml on billyjbryant/mcp-foxxy-bridge
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
mcp_foxxy_bridge-1.6.2-py3-none-any.whl -
Subject digest:
15f2a12756cefbd580267fed14bf75ae221ba60cc615854d0c45eb3d4a3407a3 - Sigstore transparency entry: 470945685
- Sigstore integration time:
-
Permalink:
billyjbryant/mcp-foxxy-bridge@472708757ffece15cacf0649d71c3bbf4abd202e -
Branch / Tag:
refs/heads/main - Owner: https://github.com/billyjbryant
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
main.yml@472708757ffece15cacf0649d71c3bbf4abd202e -
Trigger Event:
push
-
Statement type: