1MCP - 适用于所有场景的一体化MCP服务器

一个统一的Model Context Protocol服务器实现，将多个MCP服务器聚合到一个服务器中。

概览

1MCP（一体化MCP）旨在简化您与AI助手的工作方式。无需为不同的客户端（如Claude Desktop、Cherry Studio、Cursor、Roo Code、Claude等）配置多个MCP服务器，1MCP提供了一个单一且统一的服务器。

功能

• 🔄 统一接口：将多个MCP服务器聚合到一个
• 🔒 OAuth 2.1 认证：基于作用域授权的生产就绪安全
• ⚡ 高性能：高效请求转发及适当的错误处理
• 🛡️ 安全第一：Stdio传输隔离、输入净化及全面审计日志
• 🔧 易于配置：单个JSON配置文件并支持热重载
• 📈 健康监控：内置健康检查端点用于监控和可观测性

快速开始

1. 安装1MCP

二进制文件（推荐 - 不需要Node.js）：

# Linux/macOS
curl -L https://github.com/1mcp-app/agent/releases/latest/download/1mcp-linux-x64.tar.gz | tar -xz
sudo mv 1mcp /usr/local/bin/

# Windows (PowerShell)
Invoke-WebRequest -Uri "https://github.com/1mcp-app/agent/releases/latest/download/1mcp-win32-x64.zip" -OutFile "1mcp.zip"
Expand-Archive -Path "1mcp.zip" -DestinationPath "."

NPM：

npx -y @1mcp/agent --help

2. 添加MCP服务器

1mcp mcp add context7 -- npx -y @upstash/context7-mcp
1mcp mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem ~/Documents

3. 启动服务器

1mcp

4. 连接您的AI助手

对于Cursor，添加到~/.cursor/mcp.json：

{
  "mcpServers": {
    "1mcp": {
      "url": "http://127.0.0.1:3050/mcp?app=cursor"
    }
  }
}

对于VSCode，添加到settings.json：

{
  "servers": {
    "1mcp": {
      "url": "http://127.0.0.1:3050/mcp?app=vscode"
    }
  }
}

安装MCP服务器到VSCode

对于Claude Code：

claude mcp add -t http 1mcp "http://127.0.0.1:3050/mcp?app=claude-code"

就这样！现在所有的MCP服务器都可以通过一个统一的端点访问了。🎉

命令

核心命令

• 1mcp [serve] - 启动1MCP服务器（默认命令）
• 1mcp mcp add <name> - 将新的MCP服务器添加到配置
• 1mcp mcp list - 列出所有已配置的MCP服务器
• 1mcp mcp status [name] - 显示服务器状态和详细信息

要详细了解命令用法，请运行：1mcp <command> --help

文档

📚 完整文档 - 全面指南、API参考及示例

关键主题

• 安装指南 - 二进制、NPM及Docker安装
• 快速开始 - 五分钟内启动
• 配置 - CLI标志及环境变量
• 认证 - OAuth 2.1安全设置
• 架构 - 1MCP内部工作原理
• 开发 - 贡献及从源码构建

工作原理

1MCP作为代理，管理和聚合多个MCP服务器。它以子进程的形式启动和停止这些服务器，并将来自AI助手的请求转发到相应的服务器。这种架构允许所有MCP流量通过一个入口点，简化管理并减少开销。

贡献

欢迎贡献！请阅读我们的CONTRIBUTING.md，了解我们的行为准则以及提交拉取请求的过程。

许可证

本项目采用Apache许可证2.0。详情请参阅LICENSE文件。