Foxxy Bridge

# MCP Foxxy Bridge <!-- BADGIE TIME --> [](https://github.com/billyjbryant/mcp-foxxy-bridge/actions/workflows/main.yml) [](https://pypi.org/project/mcp-foxxy-bridge/) [](https://pypi.org/project/mcp-foxxy-bridge/) [](https://github.com/billyjbryant/mcp-foxxy-bridge/blob/main/LICENSE) [](https://pypi.org/project/mcp-foxxy-bridge/) [](https://github.com/billyjbryant/mcp-foxxy-bridge/stargazers) [](https://github.com/billyjbryant/mcp-foxxy-bridge/issues) [](https://github.com/billyjbryant/mcp-foxxy-bridge/tree/main/docs) <!-- END BADGIE TIME --> <p align="center"> <img src="media/mcp-foxxy-bridge_logo_trimmed.webp" alt="MCP Foxxy Bridge Logo" width="300"> </p> ## 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 ```bash # 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 ```bash # 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](docs/installation.md)** - Detailed setup and configuration - **[Configuration Guide](docs/configuration.md)** - Configuration options and examples - **[CLI Reference](docs/cli-reference.md)** - Complete command reference **🔧 Advanced Topics:** - **[API Reference](docs/api.md)** - REST API endpoints - **[OAuth Authentication](docs/oauth.md)** - OAuth setup and security - **[Daemon Management](docs/daemon-management.md)** - Background process management - **[Troubleshooting](docs/troubleshooting.md)** - Common issues and solutions --- ## Contributing & Support - [Contributing Guide](CONTRIBUTING.md) - [Issue Tracker](https://github.com/billyjbryant/mcp-foxxy-bridge/issues) - [Discussions](https://github.com/billyjbryant/mcp-foxxy-bridge/discussions) --- ## License AGPL-3.0-or-later - See [LICENSE](LICENSE) file for details. ---