MCP Router

A unified gateway for Model Context Protocol (MCP) servers that enables discovery, configuration, and access to tools from GitHub repositories through a single endpoint.

https://github.com/user-attachments/assets/f011f8bf-6c99-4a8a-8236-f8eb0a3fb9e4

📚Full documentation is available atmcpanywhere.com

- Getting Started- Quick start guide and installation
- Deployment Guide- Deploy to production with Fly.io

# Clone repository git clone https://github.com/locomotive-agency/mcp-anywhere.git cd mcp-anywhere # Install with uv (recommended) uv sync # Or install with pip pip install -e . # Configure environment cp env.example .env # Edit .env with required values: # SECRET_KEY=<secure-random-key> # ANTHROPIC_API_KEY=<your-api-key> # Start server mcp-anywhere serve http # Or: python -m mcp_anywhere serve http # Access at http://localhost:8000

# Install Fly CLI curl -L https://fly.io/install.sh | sh # Deploy application cd mcp-anywhere fly launch fly secrets set SECRET_KEY=<secure-random-key> fly secrets set JWT_SECRET_KEY=<jwt-secret-key> fly secrets set ANTHROPIC_API_KEY=<your-api-key> fly secrets set GOOGLE_OAUTH_CLIENT_ID=<google-oauth-client-id> fly secrets set GOOGLE_OAUTH_CLIENT_SECRET=<google-oauth-client-secret> fly deploy # Application available at https://your-app.fly.dev

# set the environment variable REBUILD_CONTAINERS_ON_STARTUP=false

# Configure environment cp env.example .env # Edit .env with required values: # SECRET_KEY=<secure-random-key> # ANTHROPIC_API_KEY=<your-api-key>

$ docker compose -f docker-compose.native.yml up -d --build

# fetch machine id for your app $ fly --app mcp-anywhere-app machine list $ fly console --app mcp-anywhere-app --machine <MACHINE_ID>

$ sqlite3 /.data/mcp_anywhere.db ".tables" $ sqlite3 /.data/mcp_anywhere.db "SELECT * FROM users;"

{ "mcpServers": { "mcp-anywhere": { "command": "/Users/yourname/.local/bin/uv", "args": ["run", "--directory", "/Users/yourname/Projects/mcp-anywhere", "mcp-anywhere", "connect"] } } }

Lastly, set up the MCP Anywhere application before starting Claude Desktop:

For Google OAuth (recommended for teams):
- Set up Google OAuth credentials in Google Cloud Console
- Configure environment variables:

GOOGLE_OAUTH_CLIENT_ID=your-client-id GOOGLE_OAUTH_CLIENT_SECRET=your-client-secret GOOGLE_OAUTH_REDIRECT_URI=/auth/callback OAUTH_USER_ALLOWED_DOMAIN=company.com # Optional: restrict to your domain

from fastmcp import Client from fastmcp.client.auth import BearerAuth async with Client( "https://your-app.fly.dev/mcp/", auth=BearerAuth(token="<oauth-token>") ) as client: tools = await client.list_tools()

# For MCP client connection mcp-anywhere connect # Or: python -m mcp_anywhere connect # For STDIO server mode (local Claude Desktop integration) mcp-anywhere serve stdio # For HTTP server mode with OAuth (production) mcp-anywhere serve http --host 0.0.0.0 --port 8000

- Automatic repository analysis using Claude AI
- Container health monitoring with intelligent remounting
- Support for npx, uvx, and Docker runtimes
- Selective tool enablement with per-server controls
- Enhanced server management - Start, stop, and restart servers through web interface
- Pre-configured Python interpreter with sandbox isolation

- Google OAuth integration for simplified user authentication
- Domain-based access control for organizational security
- OAuth 2.0/2.1 with PKCE support (MCP SDK implementation)
- JWT-based API authentication
- Docker container isolation for tool execution
- Session-based authentication for web interface
- Encrypted secret file storage (AES-128 with Fernet)

- Asynchronous architecture (Starlette/FastAPI)
- Health monitoring with automatic recovery
- Flexible container management with configurable startup/shutdown behavior
- Enhanced server lifecycle management with start/stop/restart controls
- Streamlined deployment process with GitHub Actions CI
- CLI support for direct tool access

Client Application → MCP Anywhere Gateway → Docker Containers → MCP Tools ↓ Web Management Interface

- Oauth review and additional provider support
- Container efficiency and latency
- Improve tests
- Documentation

SECRET_KEY # Session encryption key ANTHROPIC_API_KEY # Claude API key for repository analysis

JWT_SECRET_KEY # JWT token signing key (defaults to SECRET_KEY) WEB_PORT # Web interface port (default: 8000) DATA_DIR # Data storage directory (default: .data) DOCKER_TIMEOUT # Container operation timeout in seconds (default: 300) LOG_LEVEL # Logging level (default: INFO) GITHUB_TOKEN # GitHub token for private repository access # Container Management CLEANUP_CONTAINERS_ON_SHUTDOWN # Clean up containers on app shutdown (default: false) REBUILD_CONTAINERS_ON_STARTUP # Rebuild containers on startup (default: true) # Google OAuth (optional - enables Google authentication) GOOGLE_OAUTH_CLIENT_ID # Google OAuth client ID GOOGLE_OAUTH_CLIENT_SECRET # Google OAuth client secret GOOGLE_OAUTH_REDIRECT_URI # OAuth redirect URI (e.g., /auth/callback) OAUTH_USER_ALLOWED_DOMAIN # Restrict access to specific domain (e.g., company.com)

# Install development dependencies uv sync --group dev # Run tests uv run pytest # Run linting uv run ruff check src/ tests/ # Run type checking uv run mypy src/

# Run all tests uv run pytest # Run tests with coverage uv run pytest --cov=mcp_anywhere

uv run mcp-anywhere serve http --host 0.0.0.0 --port 8080

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

The MCP server for Bitrix24 provides AI assistants with structured access to the Bitrix24 API. It delivers up-to-date method descriptions, parameters, and valid values, allowing assistants to work with precise data instead of guesswork. This reduces code errors and accelerates Bitrix24 integration development.

One remote MCP server for 500+ production APIs — Stripe, HubSpot, Postgres, Gmail, and more. OAuth and API key auth, credential management, and a CLI.

Single tool to control all 100+ API integrations, and UI components

Agent-native developer Q&A API with MCP + A2A endpoints for citations, job pickup, and answer submission.

Self-hosted MCP gateway: convert REST/SOAP/GraphQL/SQL APIs into MCP tools with 29 pre-built adapters, OAuth2, RBAC and audit log.

A universal bridge to convert any web API into an MCP server, supporting multiple transport types.

Dynamically creates MCP servers from web API configurations, integrating any REST API, GraphQL endpoint, or web service into MCP-compatible tools.

Hosted MCP server and coordination layer for AI coding agents — live API contracts, database schema, frontend/backend mismatch detection, and shared handoff tickets for Claude Code, Cursor, Codex, and Lovable.

An MCP server that dynamically loads tools from an external JSON file configured via an environment variable.

A lightweight server exposing Axone's capabilities through the Model-Context Protocol.