1MCP - 一个 MCP 服务器，满足所有人的需求
将多个 MCP 服务器聚合为一个的统一模型上下文协议服务器实现。
概述
1MCP（One MCP）旨在简化您与 AI 助手的协作方式。1MCP 无需为不同的客户端（Claude Desktop、Cherry Studio、Cursor、Roo Code、Claude 等）配置多个 MCP 服务器，而是提供一个统一的服务器，该服务器能够：
将多个 MCP 服务器聚合到一个统一的界面
通过消除冗余服务器实例来减少系统资源的使用
简化不同 AI 助手之间的配置管理
为 AI 模型与外部工具和资源交互提供标准化方式
支持动态配置重新加载，无需重启服务器
处理正常关机和资源清理
Related MCP server: MCP Starter
快速入门
要使 Cursor 能够使用已在 Claude Desktop 中配置的现有 MCP 服务器，请按照以下步骤操作：
使用 Claude Desktop 配置文件运行 1MCP 服务器：
npx -y @1mcp/agent --config ~/Library/Application\ Support/Claude/claude_desktop_config.json
将 1MCP 服务器添加到您的 Cursor 配置文件 ( ~/.cursor/mcp.json )：
{
"mcpServers": {
"1mcp": {
"type": "http",
"url": "http://localhost:3050/sse"
}
}
}
好好享受！
用法
您可以直接使用npx运行服务器：
# Basic usage (starts server with SSE transport)
npx -y @1mcp/agent
# Use existing Claude Desktop config
npx -y @1mcp/agent --config ~/Library/Application\ Support/Claude/claude_desktop_config.json
# Use stdio transport instead of SSE
npx -y @1mcp/agent --transport stdio
# Show all available options
npx -y @1mcp/agent --help
可用选项：
--transport, -t ：选择传输类型（“stdio”或“http”，默认值：“http”）
--config, -c ：使用特定的配置文件
--port, -P ：更改 HTTP 端口（默认值：3050）
--host, -H ：更改 HTTP 主机（默认值：localhost）
--tags, -g ：按标签过滤服务器（请参阅下面的标签部分）
--help, -h ：显示帮助
环境变量示例：
# Using environment variables
ONE_MCP_PORT=3051 ONE_MCP_TAGS=network,filesystem npx -y @1mcp/agent
# Or in your shell configuration
export ONE_MCP_PORT=3051
export ONE_MCP_TAGS=network,filesystem
npx -y @1mcp/agent
Docker
您还可以使用 Docker 运行 1MCP：
# Pull the latest image
docker pull ghcr.io/1mcp-app/agent:latest
# Run with HTTP transport (default)
docker run -p 3050:3050 ghcr.io/1mcp-app/agent
# Run with a custom config file
docker run -p 3050:3050 -v /path/to/config.json:/config.json ghcr.io/1mcp-app/agent --config /config.json
# Run with stdio transport
docker run -i ghcr.io/1mcp-app/agent --transport stdio
可用的图像标签：
latest ：最新稳定版本
vX.YZ ：特定版本（例如v1.0.0 ）
sha-<commit> ：特定提交
环境变量
您可以使用以ONE_MCP_为前缀的环境变量配置 1MCP：
ONE_MCP_TRANSPORT ：传输类型（“stdio”或“http”，默认值：“http”）
ONE_MCP_PORT ：HTTP 端口（默认值：3050）
ONE_MCP_HOST ：HTTP 主机（默认值：“localhost”）
ONE_MCP_CONFIG ：配置文件路径
ONE_MCP_TAGS ：用于过滤服务器的标签的逗号分隔列表
环境变量示例：
docker run -p 3051:3051 \
-e ONE_MCP_PORT=3051 \
-e ONE_MCP_TAGS=network,filesystem \
ghcr.io/1mcp-app/agent
了解标签
标签可帮助您控制哪些 MCP 服务器可供不同客户端使用。您可以将标签视为描述每个服务器功能的一个标签。
如何使用标签
在您的服务器配置中：向每个服务器添加标签以描述其功能
{
"mcpServers": {
"web-server": {
"command": "uvx",
"args": ["mcp-server-fetch"],
"tags": ["network", "web"],
"disabled": false
},
"file-server": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "~/Downloads"],
"tags": ["filesystem"],
"disabled": false
}
}
}
在 stdio 模式下启动 1MCP 时：您可以按标签过滤服务器
# Only start servers with the "network" tag
npx -y @1mcp/agent --transport stdio --tags "network"
# Start servers with either "network" or "filesystem" tags
npx -y @1mcp/agent --transport stdio --tags "network,filesystem"
使用 SSE 传输时：客户端可以请求具有特定标签的服务器
{
"mcpServers": {
"1mcp": {
"type": "http",
"url": "http://localhost:3050/sse?tags=network" // Only connect to network-capable servers
}
}
}
示例标签：
配置
全局配置
服务器自动管理全局位置的配置：
配置文件格式
{
"mcpServers": {
"mcp-server-fetch": {
"command": "uvx",
"args": [
"mcp-server-fetch"
],
"disabled": false
},
"server-memory": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-memory"
],
"disabled": false
}
}
}
工作原理
系统架构
graph TB
subgraph "AI Assistants"
A1[Claude Desktop]
A2[Cursor]
A3[Cherry Studio]
A4[Roo Code]
end
subgraph "1MCP Server"
MCP[1MCP Agent]
end
subgraph "MCP Servers"
S1[Server 1]
S2[Server 2]
S3[Server 3]
end
A1 -->|http| MCP
A2 -->|http| MCP
A3 -->|http| MCP
A4 -->|http| MCP
MCP --> |http| S1
MCP --> |stdio| S2
MCP --> |stdio| S3
请求流程
sequenceDiagram
participant Client as AI Assistant
participant 1MCP as 1MCP Server
participant MCP as MCP Servers
Client->>1MCP: Send MCP Request
activate 1MCP
1MCP->>1MCP: Validate Request
1MCP->>1MCP: Load Config
1MCP->>MCP: Forward Request
activate MCP
MCP-->>1MCP: Response
deactivate MCP
1MCP-->>Client: Forward Response
deactivate 1MCP
发展
安装依赖项：
构建服务器：
对于使用自动重建的开发：
运行服务器：
调试
使用MCP Inspector （可作为包脚本使用）：
检查器将提供一个 URL 来访问浏览器中的调试工具。
