mcp-foxxy-bridge

MCP Foxxy Bridge

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

• Overview & Features
• Installation Guide
• Configuration Guide
• Deployment Guide
• API Reference
• Architecture Overview
• Troubleshooting Guide
• Example Configurations

---

🛠️ Development

• Development Setup
• Contributing Guide

---

🤝 Contributing & Support

• Contributing Guide
• Issue Tracker
• Discussions

---

⚖️ License

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

---