coreason-mcp

The Universal Gateway Service for the Model Context Protocol (MCP).

coreason-mcp elevates the MCP ecosystem by acting as a centralized host that aggregates tools from multiple downstream servers (both local Stdio sidecars and remote SSE microservices) and exposes them via a unified HTTP API.

Features

• Universal Connectivity: Connects to any MCP-compliant server.
• Protocol Agnostic: Supports both stdio (subprocess) and sse (HTTP) transports transparently.
• Tool Aggregation: Merges tools from all connected servers into a single namespace.
• Gateway Server: High-performance FastAPI server for persistent connections.
• Identity Injection: Securely propagates user context to tools.

Installation

Library Mode

pip install coreason-mcp

Gateway Server Mode

Using Docker (Recommended):

docker run -d \
  -p 8000:8000 \
  -v $(pwd)/config.json:/app/config.json \
  -e MCP_CONFIG_PATH=/app/config.json \
  ghcr.io/coreason-ai/coreason-mcp:latest

Using CLI:

# Install dependencies
poetry install

# Run the server
uvicorn coreason_mcp.server:app --host 0.0.0.0 --port 8000

Configuration

The gateway is configured via a JSON file (default config.json).

{
  "timeout": 30.0,
  "servers": [
    {
      "name": "brave_search",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "YOUR_API_KEY"
      }
    },
    {
      "name": "clinical_db",
      "url": "http://clinical-service:8080/sse"
    }
  ]
}

API Reference

Documentation

For full documentation, visit the docs/ directory.

License

Prosperity Public License 3.0