/ 目錄 / 演練場 / 1MCP Agent
← 全部伺服器 ↗ GitHub
● 社群 1mcp-app ⚡ 即開即用

1MCP Agent

作者 1mcp-app · 1mcp-app/agent

將你使用的所有 MCP 伺服器整合至單一端點——統一設定、統一認證、命名空間化的工具名稱，以及一個統一管理的地方。

1mcp/agent 是 MCP 伺服器的統一代理程式。一次設定所有伺服器（filesystem、github、postgres、sentry 等），你的用戶端（Claude Desktop／Cursor／Cline）只看到一個 MCP。工具名稱會加上前綴（github__create_issue），agent 處理程序的生命週期管理與健康檢查，並且可以熱重載設定而無需重啟用戶端。

▶ 觀看演示 📦 安裝 💡 使用場景

為什麼要用

核心特性

即時演示

實際使用效果

onemcp-agent.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "onemcp-agent": {
      "command": "npx",
      "args": [
        "-y",
        "@1mcp/agent"
      ]
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "onemcp-agent": {
      "command": "npx",
      "args": [
        "-y",
        "@1mcp/agent"
      ]
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "onemcp-agent": {
      "command": "npx",
      "args": [
        "-y",
        "@1mcp/agent"
      ]
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示，然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "onemcp-agent": {
      "command": "npx",
      "args": [
        "-y",
        "@1mcp/agent"
      ]
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "onemcp-agent",
      "command": "npx",
      "args": [
        "-y",
        "@1mcp/agent"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列，而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "onemcp-agent": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@1mcp/agent"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add onemcp-agent -- npx -y @1mcp/agent

一行命令搞定。用 claude mcp list 驗證，claude mcp remove 移除。

使用場景

實戰用法： 1MCP Agent

將 20 個以上的 MCP 伺服器整合至單一端點

👤 設定了大量 MCP 的進階使用者 ⏱ ~25 min intermediate

何時使用： 你的 claude_desktop_config.json 已有 20 個以上的條目，新增或移除伺服器變得非常麻煩。

前置條件
  • 1mcp 已安裝 — npx -y @1mcp/agent（或依文件說明進行持久化安裝）
步驟
  1. 將現有伺服器遷移至 1mcp 設定
    Use onemcp-agent. Convert my current MCP client config into a 1mcp config file with each server prefixed by its name.✓ 已複製
    → 1mcp.config.json 含所有伺服器及前綴
  2. 將用戶端指向 1mcp
    Replace my client's MCP config with a single entry pointing at 1mcp; keep a backup.✓ 已複製
    → 用戶端現在只看到一個伺服器；工具以前綴方式列出
  3. 熱新增伺服器
    Add the new arxiv MCP to 1mcp config and reload — without restarting Claude Desktop.✓ 已複製
    → 新工具在下次 list_tools 刷新時出現

結果： 所有 MCP 伺服器有理性的單一事實來源；迭代更快速。

注意事項
  • 帶前綴的工具名稱變得很長 — 為各伺服器使用簡短的前綴別名（gh、fs、pg）而非全名

在開發機上執行團隊共用的 MCP 技術棧

👤 使用共用基礎架構的小型開發團隊 ⏱ ~45 min advanced

何時使用： 你希望團隊所有人共用相同的 MCP 伺服器和機密，而非各自重複設定。

前置條件
  • 可存取的主機 — 在開發機上執行 1mcp，透過帶認證的 SSE／HTTP 傳輸暴露端口
步驟
  1. 集中設定
    Configure 1mcp on the dev box with our team's MCP set + shared auth tokens. Expose via authenticated SSE.✓ 已複製
    → 技術棧執行中；SSE 端點需要 bearer token
  2. 發送個別用戶端設定
    Generate per-developer client snippets pointing to the shared SSE URL with their personal bearer.✓ 已複製
    → 每位開發者一份設定片段

結果： 團隊使用經過驗證的 MCP 套件，無需每個人管理 20 份設定。

注意事項
  • 單一主機 = 單點故障 — 記錄回退至本機設定的方案；或在負載平衡器後方執行多個副本

透過 1mcp 隔離不受信任的 MCP

👤 正在嘗試社群 MCP 的安全意識使用者 ⏱ ~30 min advanced

何時使用： 你想試用第三方 MCP，但不想讓它取得你的完整環境或完整檔案系統存取權限。

步驟
  1. 在容器中執行 1mcp
    Set up 1mcp in a Docker container with minimal env; mount only ./scratch/. Add the untrusted MCP under a 'sandbox' prefix.✓ 已複製
    → 容器執行中；只有沙箱 MCP 的工具加上 sandbox/ 前綴可見
  2. 僅用於單一任務
    Run the experimental task only with sandbox__ tools.✓ 已複製
    → 任務完成；沒有東西逃出容器

結果： 試用不受信任的伺服器，而不將整個系統的控制權交出去。

注意事項
  • 忘記 MCP 在容器內仍可存取網路 — 若對外傳輸有疑慮，使用 --network none 或限制網路命名空間

組合

與其他 MCP 搭配，撬動十倍槓桿

onemcp-agent + filesystem + github

作為你日常使用伺服器集合的聚合器

Configure 1mcp with filesystem (prefix fs) + github (prefix gh) + postgres (prefix pg). Use fs__read_file and gh__create_issue from one client.✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
list_servers — 健康檢查／偵錯 0
reload_config config_path? 編輯 1mcp.config.json 後 0
restart_server server_name 子伺服器出現異常時 0
<prefix>__<tool> 依子工具規格 所有子工具均以前綴方式顯示 視子伺服器而定

成本與限制

運行它的成本

API 配額
每次呼叫新增的額外負擔可忽略不計
每次呼叫 Token 數
0——代理程式直接透傳；工具清單費用為所有子伺服器的總和
費用
免費
提示
透過設定旗標停用很少使用的子伺服器，而非移除——讓 prompt 保持精簡

安全

權限、密鑰、影響範圍

最小權限： 依各子伺服器所需而定
憑證儲存： 子伺服器環境變數集中存放在 1mcp.config.json——保護好這個檔案
資料出站： 依各子伺服器行為而定——1mcp 本身不對外傳輸，除非設定了遠端 SSE
切勿授予： 讓設定檔含有機密且全域可讀

故障排查

常見錯誤與修復

子伺服器啟動失敗

查看 1mcp 日誌中該伺服器的 stderr；通常是缺少環境變數或指令路徑錯誤

驗證： 在終端機中單獨嘗試子伺服器的指令
工具名稱衝突

在設定中為各伺服器新增或縮短前綴

驗證： list_servers 顯示目前的前綴
熱重載未套用變更

部分變更需要重啟（傳輸模式、埠口）。對受影響的子伺服器執行 restart_server 或完全重啟 1mcp

首次回應緩慢

子伺服器預設為延遲啟動——對常用伺服器設定「eager: true」

替代方案

1MCP Agent 對比其他方案

替代方案何時用它替代權衡
metamcp你需要有介面管理的聚合器，以及團隊工作流程功能較重量級；有更強的主觀意見
mcp-router（TheLunarCompany/lunar）你需要治理與稽核日誌（企業級）功能面更廣；設定更複雜

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills