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