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

更多詳細信息請參考官方文檔。