1MCP - One MCP Server for All

1# 1MCP - One MCP Server for All
2 
3A unified Model Context Protocol server implementation that aggregates multiple MCP servers into one.
4 
5[![NPM Version](https://img.shields.io/npm/v/@1mcp/agent)](https://www.npmjs.com/package/@1mcp/agent)
6[![NPM Downloads](https://img.shields.io/npm/dm/%401mcp%252Fagent)](https://www.npmjs.com/package/@1mcp/agent)
7[![CodeQl](https://github.com/1mcp-app/agent/actions/workflows/github-code-scanning/codeql/badge.svg)](https://github.com/1mcp-app/agent/actions/workflows/github-code-scanning/codeql)
8[![GitHub Repo stars](https://img.shields.io/github/stars/1mcp-app/agent)](https://github.com/1mcp-app/agent/stargazers)
9[![1MCP Docs](https://img.shields.io/badge/1MCP-Official%20Docs-blue)](https://docs.1mcp.app)
10[![DeepWiki](https://img.shields.io/badge/DeepWiki-AI%20Docs-purple.svg?logo=gitbook&logoColor=white)](https://deepwiki.com/1mcp-app/agent)
11[![NPM License](https://img.shields.io/npm/l/@1mcp/agent)](https://www.npmjs.com/package/@1mcp/agent)
12 
13## Overview
14 
151MCP (One MCP) is designed to simplify the way you work with AI assistants. Instead of configuring multiple MCP servers for different clients (Claude Desktop, Cherry Studio, Cursor, Roo Code, Claude, etc.), 1MCP provides a single, unified server.
16 
17## Features
18 
19- **🔄 Unified Interface**: Aggregates multiple MCP servers into one
20- **🔒 OAuth 2.1 Authentication**: Production-ready security with scope-based authorization
21- **⚡ High Performance**: Efficient request forwarding with proper error handling
22- **🛡️ Security First**: Stdio transport isolation, input sanitization, and comprehensive audit logging
23- **🔧 Easy Configuration**: Single JSON configuration file with hot-reload support
24- **📈 Health Monitoring**: Built-in health check endpoints for monitoring and observability
25 
26## Quick Start
27 
28### 1. Install 1MCP
29 
30**Binary (Recommended - No Node.js Required):**
31 
32```bash
33# Linux/macOS
34curl -L https://github.com/1mcp-app/agent/releases/latest/download/1mcp-linux-x64.tar.gz | tar -xz
35sudo mv 1mcp /usr/local/bin/
36 
37# Windows (PowerShell)
38Invoke-WebRequest -Uri "https://github.com/1mcp-app/agent/releases/latest/download/1mcp-win32-x64.zip" -OutFile "1mcp.zip"
39Expand-Archive -Path "1mcp.zip" -DestinationPath "."
40```
41 
42**NPM:**
43 
44```bash
45npx -y @1mcp/agent --help
46```
47 
48### 2. Add MCP Servers
49 
50```bash
511mcp mcp add context7 -- npx -y @upstash/context7-mcp
521mcp mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem ~/Documents
53```
54 
55### 3. Start the Server
56 
57```bash
581mcp
59```
60 
61### 4. Connect Your AI Assistant
62 
63**For Cursor**, add to `~/.cursor/mcp.json`:
64 
65```json
66{
67  "mcpServers": {
68    "1mcp": {
69      "url": "http://127.0.0.1:3050/mcp?app=cursor"
70    }
71  }
72}
73```
74 
75[![Install MCP Server to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](cursor://anysphere.cursor-deeplink/mcp/install?name=1mcp&config=eyJ1cmwiOiJodHRwOi8vMTI3LjAuMC4xOjMwNTAvbWNwP2FwcD1jdXJzb3IifQ%3D%3D)
76 
77**For VSCode**, add to `settings.json`:
78 
79```json
80{
81  "servers": {
82    "1mcp": {
83      "url": "http://127.0.0.1:3050/mcp?app=vscode"
84    }
85  }
86}
87```
88 
89[Install MCP Server to VSCode](vscode:mcp/install?%7B%22name%22%3A%221mcp%22%2C%22url%22%3A%22http%3A%2F%2F127.0.0.1%3A3050%2Fmcp%3Fapp%3Dvscode%22%7D)
90 
91**For Claude Code:**
92 
93```bash
94claude mcp add -t http 1mcp "http://127.0.0.1:3050/mcp?app=claude-code"
95```
96 
97That's it! All your MCP servers are now available through one unified endpoint. 🎉
98 
99## Commands
100 
101### Core Commands
102 
103- **`1mcp [serve]`** - Start the 1MCP server (default command)
104- **`1mcp mcp add <name>`** - Add a new MCP server to configuration
105- **`1mcp mcp list`** - List all configured MCP servers
106- **`1mcp mcp status [name]`** - Show server status and details
107 
108For detailed command usage, run: `1mcp <command> --help`
109 
110## Documentation
111 
112📚 **[Complete Documentation](https://docs.1mcp.app)** - Comprehensive guides, API reference, and examples
113 
114### Key Topics
115 
116- **[Installation Guide](https://docs.1mcp.app/guide/installation)** - Binary, NPM, and Docker installation
117- **[Quick Start](https://docs.1mcp.app/guide/quick-start)** - Get running in 5 minutes
118- **[Configuration](https://docs.1mcp.app/guide/essentials/configuration)** - CLI flags and environment variables
119- **[Authentication](https://docs.1mcp.app/guide/advanced/authentication)** - OAuth 2.1 security setup
120- **[Architecture](https://docs.1mcp.app/reference/architecture)** - How 1MCP works internally
121- **[Development](https://docs.1mcp.app/guide/development)** - Contributing and building from source
122 
123## How It Works
124 
1251MCP acts as a proxy, managing and aggregating multiple MCP servers. It starts and stops these servers as subprocesses and forwards requests from AI assistants to the appropriate server. This architecture allows for a single point of entry for all MCP traffic, simplifying management and reducing overhead.
126 
127## Contributing
128 
129Contributions are welcome! Please read our [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.
130 
131## License
132 
133This project is licensed under the Apache License 2.0. See the [LICENSE](LICENSE) file for details.
134