Agent

🚀 1MCP 代理服务器

1MCP 代理服务器（简称“1MCP”）是一款用于集中管理多个 MCP 服务器的实用工具。借助它，AI 助手能够通过单一接口调用不同功能的服务器，无需直接管理每个服务器，极大提升了使用效率。

🚀 快速开始

全局配置文件位置

1MCP 的全局配置文件存放位置如下：

• macOS/Linux：~/.config/1mcp/mcp.json
• Windows：%APPDATA%/1mcp/mcp.json

配置文件格式示例

{
  "mcpServers": {
    "mcp-server-fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"],
      "disabled": false
    },
    "server-memory": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-memory"
      ],
      "disabled": false
    }
  }
}

启动命令

# 标准模式
pnpm dev

# 标准输入输出模式
pnpm dev-stdio

✨ 主要特性

• 统一接口：AI 助手可通过 SSE 或 HTTP 协议与 1MCP 进行通信。
• 多服务器管理：能够同时运行多个 MCP 服务器实例。
• 标签控制：可通过标签选择性地启用或禁用服务器。
• 请求路由：能根据具体需求将请求分发到合适的服务器。

📚 详细文档

系统架构图

graph TB
    subgraph "AI 助手"
        A1[Claude Desktop]
        A2[Cursor]
        A3[Cherry Studio]
        A4[Roo Code]
    end

    subgraph "1MCP 代理服务器"
        MCP[1MCP Agent]
    end

    subgraph "MCP 服务器"
        S1[Server 1]
        S2[Server 2]
        S3[Server 3]
    end

    A1 -->|sse| MCP
    A2 -->|sse| MCP
    A3 -->|sse| MCP
    A4 -->|sse| MCP

    MCP --> |sse| S1
    MCP --> |stdio| S2
    MCP --> |stdio| S3

请求流程图

sequenceDiagram
    participant 客户端 as AI 助手
    participant 代理服务器 as 1MCP Server
    participant MCP 服务器 as MCP Servers

    客户端->>代理服务器: 发送 MCP 请求
    activate 代理服务器

    代理服务器->>代理服务器: 验证请求
    代理服务器->>代理服务器: 加载配置
    代理服务器->>MCP 服务器: 转发请求
    activate MCP 服务器

    MCP 服务器-->>代理服务器: 响应
    deactivate MCP 服务器

    代理服务器-->>客户端: 转发响应
    deactivate 代理服务器

标签使用说明

标签定义示例

{
  "mcpServers": {
    "web-server": {
      "command": "uvx",
      "args": ["mcp-server-web"],
      "disabled": false,
      "tags": ["web", "http"]
    },
    "file-server": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-file"],
      "disabled": false,
      "tags": ["file", "storage"]
    }
  }
}

标签过滤规则

• 包含标签：--tag=web 或 --tag=file
• 排除标签：--exclude-tag=debug
• 组合使用：--tag=web --exclude-tag=test

开发信息

项目结构

1mcp/
├── src/              # 源代码目录
│   ├── main.ts       # 主程序入口
│   └── server.ts     # 代理服务器实现
├── package.json      # 依赖管理文件
└── tsconfig.json     # TypeScript 配置文件

开发命令

# 安装依赖
pnpm install

# 启动开发环境
pnpm dev

# 打包构建
pnpm build

更多详细信息请参考官方文档。