Impart MCP

🚀 Impart MCP（智能體編排層）

impart-mcp 是一個基於 Model Context Protocol (MCP) 的智能體編排服務器。它作為「Agent 編排層」，將具備高度工程化能力的專家智能體（如 Claude Code、Codex CLI 等）封裝為標準 MCP 工具，讓宿主環境（Claude Desktop、Cursor 等）能通過統一接口調用這些具備複雜任務處理能力的「超級 Agent」。

🚀 快速開始

impart-mcp 是一個強大的智能體編排服務器，能幫助你更高效地調用各種專家智能體。下面將為你介紹它的安裝、配置和使用方法。

✨ 主要特性

• 多智能體編排：內置 5 種預設專家提示詞和工具權限的專業 Agent。
• 跨平臺集成：完美適配 Claude Desktop、Cursor、Gemini CLI 等支持 MCP 的環境。
• 異步任務處理：支持耗時任務的後臺運行與結果輪詢。
• 混合模型供應商：集成 Vercel AI SDK，支持 Claude Code、Codex CLI 和 Gemini CLI 驅動的 Agent。
• 靈活配置：通過 JSON 配置文件自定義每個 Agent 的模型、開關及參數。

🛠️ 專家智能體 (Agents)

📦 安裝指南

方式一：npx 直接運行（推薦）

無需安裝，直接在 MCP 配置中使用：

npx impart-mcp@latest

方式二：全局安裝

npm install -g impart-mcp
# 或
bun add -g impart-mcp

方式三：從源碼安裝

前置要求：Bun 或 Node.js >= 18

git clone <repository-url>
cd impart-mcp
bun install  # 或 npm install
bun run build  # 構建產物

💻 使用示例

配置到 Cursor

1. 打開 Cursor 設置 -> Features -> MCP。
2. 添加新的 MCP Server。
3. Name: impart-mcp
4. Type: command
5. Command: npx impart-mcp@latest（或全局安裝後直接使用 impart-mcp）

配置到 Claude Code

使用 claude mcp add 命令一鍵添加：

claude mcp add impart-mcp -- npx impart-mcp@latest

或全局安裝後：

claude mcp add impart-mcp -- impart-mcp

⚙️ 詳細文檔

配置說明

默認情況下，所有 Agent 使用內置的默認配置即可運行，無需額外配置。

自定義配置（可選）

如需自定義 Agent 的模型或開關，可通過環境變量 AGENT_CONFIG_PATH 指定配置文件路徑：

{
  "mcpServers": {
    "impart-mcp": {
      "command": "npx",
      "args": ["impart-mcp@latest"],
      "env": {
        "AGENT_CONFIG_PATH": "/path/to/your/agent-config.json"
      }
    }
  }
}

自動初始化：若指定的配置文件不存在，系統會在首次運行時自動生成包含所有默認值的配置模板，方便你按需修改。

配置文件示例 (agent-config.json)：

{
  "advisor": {
    "model": "codex/gpt-5.2",
    "enabled": true
  },
  "researcher": {
    "model": "claude/sonnet",
    "enabled": true
  },
  "frontend-ui-ux-engineer": {
    "model": "gemini/gemini-3-pro-preview",
    "enabled": true
  }
}

📋 API 文檔

服務器提供了以下核心工具：

參數說明

call_agent / call_agent_async：

• agent：Agent 名稱枚舉 (advisor | researcher | explore | frontend-ui-ux-engineer | document-writer)
• prompt：任務描述
• cwd：工作目錄（必填）
• context：可選上下文信息

👨‍💻 技術細節

開發說明

核心邏輯路徑

📄 許可證

MIT License