This project provides an MCP proxy server that aggregates and serves multiple MCP resource servers through a single HTTP endpoint. It is designed for developers and researchers working with the Model Context Protocol (MCP) who need to consolidate various MCP tools and capabilities into a unified interface, enabling real-time updates and flexible client configurations.

How It Works

The proxy acts as a central hub, connecting to multiple MCP resource servers via different transport types: stdio (command-line execution), SSE (Server-Sent Events), and streamable-http. It aggregates the tools and capabilities exposed by these servers, presenting them through a single HTTP server. This approach simplifies client interactions by abstracting away the underlying server implementations and provides real-time updates via SSE.

Quick Start & Requirements

• Installation:
  • Build from source: git clone https://github.com/TBXark/mcp-proxy.git && cd mcp-proxy && make build && ./build/mcp-proxy --config path/to/config.json
  • Go install: go install github.com/TBXark/mcp-proxy@latest
  • Docker: docker run -d -p 9090:9090 -v /path/to/config.json:/config/config.json ghcr.io/tbxark/mcp-proxy:latest
• Prerequisites: Go (for building from source), Docker. Configuration requires a JSON file.
• Documentation: https://tbxark.github.io/mcp-proxy

Highlighted Details

• Supports multiple MCP client types: stdio, SSE, and streamable-http.
• Provides Server-Sent Events (SSE) for real-time updates.
• Offers flexible configuration via JSON, including tool filtering (allow/block lists).
• Allows authentication via tokens in the Authorization header.

Maintenance & Community

• No specific contributors, sponsorships, or community links (Discord/Slack) are mentioned in the README.

Licensing & Compatibility

• License: MIT License.
• Compatibility: Permissive MIT license allows for commercial use and integration with closed-source projects.

Limitations & Caveats

The README does not detail specific limitations, known bugs, or deprecation status. The project is inspired by another repository, suggesting potential for rapid evolution or reliance on its predecessor's stability.