Impart MCP (Agent Orchestration Layer)

impart-mcp 是一个基于 Model Context Protocol (MCP) 的智能体编排服务器。它充当「Agent 编排层」，将具备高度工程化能力的专家智能体（如 Claude Code, Codex CLI 等）封装为标准 MCP 工具，使宿主环境（Claude Desktop, Cursor 等）能够通过统一接口调用这些具备复杂任务处理能力的「超级 Agent」。

🚀 核心特性

• 多智能体编排：内置 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 文档 (MCP Tools)

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

参数说明

`call_agent` / `call_agent_async`：

• agent：Agent 名称枚举 (advisor | researcher | explore | frontend-ui-ux-engineer | document-writer)
• prompt：任务描述
• cwd：工作目录（必填）
• context：可选上下文信息

👨‍💻 开发说明

核心逻辑路径

📄 许可证

MIT License