1MCP Server
A unified Model Context Protocol server that aggregates multiple MCP servers into one, allowing AI assistants like Claude Desktop, Cursor, and Cherry Studio to connect to a single server instead of managing multiple instances.
What is 1MCP Server?
1MCP Server is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to unified model context protocol server that aggregates multiple mcp servers into one, allowing ai assistants like claude desktop, cursor, and cherry studio to connect to a single server instead of mana...
A unified Model Context Protocol server that aggregates multiple MCP servers into one, allowing AI assistants like Claude Desktop, Cursor, and Cherry Studio to connect to a single server instead of managing multiple instances.
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A unified Model Context Protocol server that aggregates mult
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx 1mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use 1MCP Server
1MCP is a unified MCP aggregator that lets AI clients like Claude Desktop, Cursor, and Cherry Studio connect to a single server instead of managing dozens of individual MCP server entries. It reads a .1mcprc configuration file to discover static and template-based MCP servers, materializes them on demand, and exposes all their tools through one endpoint with progressive discovery via inspect and run commands. Teams use 1MCP to simplify client configuration, reduce startup overhead, and enable per-session or per-client tool customization without touching every client config.
Prerequisites
- Node.js 18 or later with npm available
- An MCP-compatible client such as Claude Desktop, Cursor, or Cherry Studio
- The upstream MCP servers you want to aggregate already installable via npm or another package manager
- A .1mcprc file in your project or home directory to declare server configurations
Install 1MCP globally
Install the @1mcp/agent package globally so the 1mcp CLI is available system-wide.
npm install -g @1mcp/agentAdd upstream MCP servers to 1MCP
Use the 1mcp mcp add command to register upstream servers. 1MCP stores these in its configuration so clients see them as a unified set of tools.
1mcp mcp add context7 -- npx -y @upstash/context7-mcpStart the 1MCP aggregator
Run 1mcp serve to start the aggregator. It materializes configured servers and listens for incoming MCP client connections.
1mcp serveConfigure your AI client to connect to 1MCP
Add a single 1mcp entry to your client config instead of listing each individual server. 1MCP handles routing to all upstream servers.
{
"mcpServers": {
"1mcp": {
"command": "1mcp",
"args": ["serve"]
}
}
}(Optional) Set up agent-specific initialization
1MCP has built-in setup helpers for Claude Code and Codex that configure the correct scopes and repo root.
1mcp cli-setup --claude --scope repo --repo-root .
# or for Codex:
1mcp cli-setup --codexDiscover and run tools via the CLI
Use the 1mcp inspect and 1mcp run commands to explore available servers and tools, and to test tool calls from the terminal.
1mcp inspect
1mcp inspect context7
1mcp run context7/query-docs --args '{"libraryId":"/mongodb/docs","query":"aggregation pipeline"}'1MCP Server Examples
Client configuration
Claude Desktop config using the globally installed 1mcp binary. All upstream servers are managed in .1mcprc — only one entry needed here.
{
"mcpServers": {
"1mcp": {
"command": "1mcp",
"args": ["serve"]
}
}
}Prompts to try
Example prompts when 1MCP is aggregating multiple upstream MCP servers into a single connection.
- "List all the tools and servers available through 1MCP right now"
- "Use the Context7 server to find documentation about MongoDB aggregation pipelines"
- "Search the web using whichever search MCP server is configured"
- "Read my project README using the file system tools from the aggregated servers"
- "Show me which upstream MCP servers are active and healthy"Troubleshooting 1MCP Server
1mcp command not found after global install
Run npm config get prefix to find the global npm directory, then add <prefix>/bin to your PATH. Restart your terminal or source your shell profile. Verify with which 1mcp.
Upstream server tools are not appearing in the client
Run 1mcp inspect in the terminal to see which servers and tools are discovered. If a server is missing, check that it was added with 1mcp mcp add and that its command resolves correctly. Use 1mcp serve in a terminal to see startup logs.
.1mcprc configuration is not being picked up
The .1mcprc file should be in your project root or home directory. Run 1mcp serve from the directory containing the file, or specify the config path explicitly. Check for JSON syntax errors using a JSON linter.
Frequently Asked Questions about 1MCP Server
What is 1MCP Server?
1MCP Server is a Model Context Protocol (MCP) server that unified model context protocol server that aggregates multiple mcp servers into one, allowing ai assistants like claude desktop, cursor, and cherry studio to connect to a single server instead of managing multiple instances. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install 1MCP Server?
Follow the installation instructions on the 1MCP Server GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with 1MCP Server?
1MCP Server works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is 1MCP Server free to use?
Yes, 1MCP Server is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.
1MCP Server Alternatives — Similar Developer Tools Servers
Looking for alternatives to 1MCP Server? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up 1MCP Server in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use 1MCP Server?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.