MCP Connect


A production-ready proxy and multiplexing server for the Model Context Protocol (MCP). MCP Connect enables seamless integration between local MCP clients and remote HTTP servers with OAuth support.

Works With

Connect your favorite AI agents to remote MCP servers:

| Agent | Description |
|-------|-------------|
| Claude Desktop | Anthropic's official desktop app |
| Claude Code | Anthropic's CLI coding assistant |
| Cursor | AI-powered code editor |
| Windsurf | Codeium's AI IDE |
| Zed | High-performance code editor |
| Continue | Open-source AI assistant for VSCode/JetBrains |

Features

- Remote Server Support - Connect to multiple remote MCP servers via HTTP/HTTPS
- OAuth Authentication - Automatic OAuth 2.0 flow with token caching
- Centralized Configuration - Manage all servers in a single .mcp-connect.json file
- Registry Integration - Search and discover servers from the official MCP Registry
- Multiplexing - Access multiple servers through a single connection with namespace routing
- IDE Integration - Auto-generate configuration for Zed, VSCode, and Cursor

Installation

$3

``bash
npx @dreygur/mcp https://remote.server/mcp
`

$3

`bash
npm install -g @dreygur/mcp
`

$3

`bash
curl -fsSL https://raw.githubusercontent.com/dreygur/mcp-connect/main/scripts/install.sh | bash
`

$3

`powershell
irm https://raw.githubusercontent.com/dreygur/mcp-connect/main/scripts/install.ps1 | iex
`

$3

`bash


From GitHub

cargo install --git https://github.com/dreygur/mcp-connect

From crates.io (when published)

cargo install mcp-connect
`

$3

`bash
git clone https://github.com/dreygur/mcp-connect.git
cd mcp-connect
cargo install --path crates/mcp-connect
`

$3

Download from releases page for:
- Linux (x86_64)
- macOS (x86_64, ARM64)
- Windows (x86_64)

Quick Start

One-off connection (no config needed):
`bash
npx @dreygur/mcp https://remote.mcp.server/sse
`

With auth token:
`bash
npx @dreygur/mcp https://api.example.com/mcp --auth-token "your_token"
`

Multi-server setup:
`bash


Initialize configuration

mcp-connect init

Add a server from registry

mcp-connect config add github modelcontextprotocol/github-mcp-server

Configure credentials

echo "GITHUB_TOKEN=your_token" >> .env

Generate IDE configuration

mcp-connect generate --ide vscode

Start the server

mcp-connect serve
`

Documentation

Full documentation is available at dreygur.js.org/mcp-connect

- Installation Guide
- Getting Started
- Configuration Reference
- IDE Setup - Zed, VSCode, Cursor
- Registry Management
- Troubleshooting

Architecture

`
crates/
├── mcp-types/ # Common types and traits
├── mcp-server/ # Server-side MCP (STDIO)
├── mcp-client/ # Client for remote HTTP servers
├── mcp-proxy/ # Message forwarding and routing
├── mcp-registry/ # MCP Registry API client
├── mcp-config/ # Configuration management
└── mcp-connect/ # CLI
`

See ARCHITECTURE.md for details.

Configuration Example

`json
{
"version": "1.0",
"envFile": ".env",
"routing": {
"method": "namespace-prefix",
"separator": "/"
},
"servers": {
"github": {
"name": "github-mcp-server",
"remote": {
"type": "streamable-http",
"url": "https://api.githubcopilot.com/mcp",
"headers": [
{
"key": "Authorization",
"value": "Bearer ${GITHUB_TOKEN}"
}
]
}
}
}
}
``

Requirements

- Node.js 14+ (for npm installation)
- Rust 1.75+ (for building from source)

Contributing

See Contributing Guide for details.

License

MIT License - see LICENSE for details.

Support

If you find MCP Connect useful, please consider giving it a star on GitHub! It helps others discover the project.


Acknowledgments

- RMCP - Rust SDK for Model Context Protocol
- Tokio - Asynchronous runtime for Rust