Foxy MCP Proxy

JSON-RPC router combining multiple MCP backends into one endpoint. Supports STDIO (local) and HTTP (remote) transports with API key auth and Stripe billing.

Quick Start

npx @stratum/mcp-proxy

Or install globally:

npm install -g @stratum/mcp-proxy
mcp-proxy

MCP Client Configuration

Claude Desktop (STDIO mode)

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "foxy-proxy": {
      "command": "npx",
      "args": ["@stratum/mcp-proxy"]
    }
  }
}

Remote HTTP Mode

For remote access with API key authentication:

{
  "mcpServers": {
    "foxy-proxy": {
      "url": "https://your-proxy.koyeb.app/mcp",
      "headers": {
        "Authorization": "Bearer mcp_sk_your_api_key"
      }
    }
  }
}

Get your API key from the dashboard.

Features

• Multi-backend routing - Combine multiple MCP servers with namespaced tools
• Dual transport - STDIO for local, HTTP for remote access
• API key authentication - SHA-256 hashed keys with mcp_sk_ prefix
• Usage-based billing - Stripe Meters API integration
• Rate limiting - Per-user request limits by tier
• Dashboard - Next.js app for key management and billing

Tier Limits

| Tier | Requests/month | Backends | Price | |------|----------------|----------|-------| | free | 5,000 | 3 | $0 | | pro | 100,000 | 10 | $7/mo | | max | 500,000 | unlimited | $10/mo |

Environment Variables

Required for HTTP mode

| Variable | Description | |----------|-------------| | SUPABASE_URL | Supabase project URL | | SUPABASE_SERVICE_ROLE_KEY | Supabase service role key | | UPSTASH_REDIS_REST_URL | Upstash Redis URL for rate limiting | | UPSTASH_REDIS_REST_TOKEN | Upstash Redis token |

Optional

| Variable | Description | Default | |----------|-------------|---------| | PORT | HTTP server port | 3000 | | HTTP_MODE | Enable HTTP mode | false | | ALLOWED_HOSTS | Comma-separated allowed hosts | localhost,127.0.0.1 |

Backend Configuration

Configure backends in config/backends.json:

{
  "backends": [
    {
      "name": "filesystem",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
    },
    {
      "name": "github",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxx"
      }
    }
  ]
}

Tools are namespaced: filesystem__read_file, github__search_repositories.

Development

# Clone and install
git clone https://github.com/anthropic/mcp-proxy.git
cd mcp-proxy
bun install

# STDIO mode (local)
bun run dev:stdio

# HTTP mode (remote)
bun run dev:http

# Dashboard
cd dashboard && bun run dev

License

MIT