chora-gateway 0.1.0

MCP Gateway for unified tool aggregation and request routing across multiple MCP servers

chora-gateway

MCP Gateway for unified tool aggregation and request routing across multiple MCP servers.

Features

• Tool Aggregation: Discover and aggregate tools from multiple MCP servers
• Request Routing: Route MCP requests to appropriate backend servers
• Service Discovery: Integration with chora-manifest for automatic server discovery
• Unified Endpoint: Single MCP endpoint exposing all available tools
• Health Monitoring: Track health status of all registered MCP servers
• Multi-Interface Support: Native API, CLI, REST API, and MCP server modes

Installation

From PyPI (Recommended)

pip install chora-gateway

From Source (Development)

git clone https://github.com/liminalcommons/chora-gateway.git
cd chora-gateway
poetry install

Quick Start

1. Native API (Python Library)

from chora_gateway import Gateway

# Initialize gateway with manifest integration
gateway = Gateway(manifest_url="http://localhost:8081")

# List all available tools
tools = gateway.list_tools()

# Route a tool invocation
result = gateway.invoke_tool("manifest.list_servers", {})

2. CLI (Command-Line Interface)

# Start gateway server
chora-gateway serve --port 8080

# List all aggregated tools
chora-gateway list-tools

# Check gateway health
chora-gateway health

3. REST API (HTTP Server)

# Start HTTP server
chora-gateway serve --mode http --port 8080

# Query tools via HTTP
curl http://localhost:8080/tools

# Invoke tool via HTTP
curl -X POST http://localhost:8080/tools/invoke \
  -H "Content-Type: application/json" \
  -d '{"tool": "manifest.list_servers", "arguments": {}}'

4. MCP Server (AI Agent Integration)

# Start MCP stdio server (for Cline, Claude Desktop)
chora-gateway serve --mode mcp-stdio

# Or start MCP HTTP server
chora-gateway serve --mode mcp-http --port 8080

Architecture

┌─────────────────────────────────────────────┐
│          AI Client (Claude, Cline)          │
└──────────────────┬──────────────────────────┘
                   │ MCP Protocol
         ┌─────────▼──────────┐
         │   chora-gateway    │
         │   (Unified MCP)    │
         └────────┬───────────┘
                  │
      ┌───────────┼────────────┐
      │           │            │
  ┌───▼───┐   ┌──▼───┐    ┌──▼─────┐
  │Manifest│   │ n8n  │    │ GitHub │
  │Server  │   │Server│    │ Server │
  └────────┘   └──────┘    └────────┘

Configuration

The gateway can be configured via:

1. Environment variables: CHORA_GATEWAY_*
2. Configuration file: ~/.chora/gateway.yaml
3. CLI arguments: --manifest-url, --port, etc.

Example configuration file:

# ~/.chora/gateway.yaml
manifest_url: http://localhost:8081
port: 8080
log_level: INFO
health_check_interval: 30

Documentation

• Full Documentation
• Architecture
• How-To Guides
• API Reference
• Contributing

Development

Setup

# Clone repository
git clone https://github.com/liminalcommons/chora-gateway.git
cd chora-gateway

# Install dependencies
poetry install

# Run tests
poetry run pytest

# Run with coverage
poetry run pytest --cov

Running Locally

# Start gateway server (requires manifest server running)
poetry run chora-gateway serve --port 8080

Contributing

See CONTRIBUTING.md for contribution guidelines.

License

MIT

Related Projects

• chora-manifest - MCP server registry and discovery
• chora-orchestration - Docker orchestration for MCP servers
• chora-base - Shared adoption patterns (SAPs)