AI任务管理服务

手部多模态计算平台（Manus MCP，此处为根据上下文推测的翻译，具体名称可能需根据实际产品或项目定义调整）

Manus AI的通用MCP服务器使您能够创建AI任务、管理Webhooks，并将Manus工作流程集成到任何兼容MCP的客户端中。该服务器专为优先响应式使用而设计，全面支持附件、连接器和实时通知功能。

安装

先决条件

• Node.js 18及以上版本
• 设定；套装；一套 MANUS_MCP_API_KEY 在你的环境中

获取API密钥

• 从（某处）获取您的API密钥 Manus 仪表盘
• API文档：https://open.manus.ai/docs
• 入门指南：https://open.manus.ai/docs/quickstart

本地构建

cd /path/to/manus-mcp
npm i
npm run build

设置：Claude 代码（命令行界面）

使用这个单行命令（替换为您的真实API密钥）：

claude mcp add manus-mcp -s user -e MANUS_MCP_API_KEY="your-api-key-here" -- npx manus-mcp

注使用 manus-mcp (not "Manus MCP"（作为名称）。Claude CLI 要求名称中不包含空格。

要删除：

claude mcp remove manus-mcp

设置：光标

创造 .cursor/mcp.json 在你的客户端（不要在这里提交）：

{
  "mcpServers": {
    "manus-mcp": {
      "command": "npx",
      "args": ["manus-mcp"],
      "env": { "MANUS_MCP_API_KEY": "your-api-key-here" },
      "autoStart": true
    }
  }
}

注这个存储库不包含 .cursor/mcp.json通过用户界面配置光标，或在客户端工作区中手动创建文件。

其他客户和代理

code --add-mcp '{"name":"manus-mcp","command":"npx","args":["manus-mcp"],"env":{"MANUS_MCP_API_KEY":"your-api-key-here"}}'

{
  "mcp.servers": {
    "manus-mcp": {
      "command": "npx",
      "args": ["manus-mcp"],
      "env": { "MANUS_MCP_API_KEY": "your-api-key-here" }
    }
  }
}

code-insiders --add-mcp '{"name":"manus-mcp","command":"npx","args":["manus-mcp"],"env":{"MANUS_MCP_API_KEY":"your-api-key-here"}}'

{
  "mcpServers": {
    "manus-mcp": {
      "command": "npx",
      "args": ["manus-mcp"],
      "env": { "MANUS_MCP_API_KEY": "your-api-key-here" }
    }
  }
}

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "manus-mcp": {
      "type": "local",
      "command": ["npx", "manus-mcp"],
      "enabled": true,
      "env": { "MANUS_MCP_API_KEY": "your-api-key-here" }
    }
  }
}

{
  "command": "npx",
  "args": ["manus-mcp"],
  "env": { "MANUS_MCP_API_KEY": "your-api-key-here" }
}

{
  "manus-mcp": {
    "command": "npx",
    "args": ["manus-mcp"],
    "env": { "MANUS_MCP_API_KEY": "your-api-key-here" }
  }
}

设置：Codex（TOML格式）

在你的 Codex TOML 配置中添加以下内容：

[mcp_servers.manus-mcp]
command = "npx"
args = ["manus-mcp"]

[mcp_servers.manus-mcp.env]
MANUS_MCP_API_KEY = "your-api-key-here"
# MCP_NAME = "manus-mcp"  # Optional: override server name

配置（环境）

• MANUS_MCP_API密钥您的Manus API密钥（必填）
• MANUS_MCP_API基础URL覆盖API基础URL（默认： https://api.manus.ai/v1)
• **MCP_NAME 翻译成中文是“MCP名称”**服务器名称覆盖（默认： manus-mcp)

可用工具

create_task

在Manus中创建一个新的AI任务，设置自定义参数并可选择添加附件。

输入:

{
  "prompt": "string (required) - The task prompt or instruction for the AI",
  "mode": "string (required) - 'speed' or 'quality'",
  "attachments": "array (optional) - List of attachment objects { filename, url, mime_type, size_bytes }",
  "connectors": "array (optional) - List of connector IDs (e.g., ['gmail', 'notion'])",
  "hide_in_task_list": "boolean (optional) - Hide from webapp task list (default: false)",
  "create_shareable_link": "boolean (optional) - Generate a public shareable link (default: false)"
}

输出：

{
  "task_id": "string - Unique task identifier",
  "task_title": "string - Generated task title",
  "task_url": "string - Direct link to the task",
  "shareURL": "string (optional) - Public shareable link if requested"
}

create_webhook

注册一个新的Webhook以接收来自Manus的实时通知。

输入：

{
  "url": "string (required) - Webhook endpoint URL",
  "events": "array (optional) - List of event types to subscribe to"
}

输出： Webhook注册详情，包括Webhook ID和配置。

delete_webhook

通过其ID移除之前注册的webhook。

输入：

{
  "webhook_id": "string (required) - The ID of the webhook to delete"
}

输出： 成功确认或错误详情。

示例调用（MCP工具调用）

以快速模式创建任务：

{
  "tool": "create_task",
  "arguments": {
    "prompt": "Analyze the quarterly sales data and generate a summary report with key insights",
    "mode": "speed",
    "create_shareable_link": true
  }
}

创建一个带有附件的任务：

{
  "tool": "create_task",
  "arguments": {
    "prompt": "Extract key action items from this meeting transcript",
    "mode": "quality",
    "attachments": [
      {
        "filename": "meeting-notes.pdf",
        "url": "https://example.com/files/meeting-notes.pdf",
        "mime_type": "application/pdf",
        "size_bytes": 245632
      }
    ],
    "connectors": ["gmail", "notion"]
  }
}

故障排除

401 认证错误

• 验证以确认 MANUS_MCP_API_KEY 在您的环境中已正确设置
• 请检查您的API密钥是否有效且未过期
• 用直接的curl请求测试您的API密钥：
  复制

  curl -H "API_KEY: your-key" https://api.manus.ai/v1/tasks
  

Node.js 版本错误

• 确保您使用的是 Node.js 18 或更高版本： node -v
• 如有必要，请更新 Node.js：https://nodejs.org/

构建问题

• 清理构建目录： rm -rf build
• 重新安装依赖项： rm -rf node_modules && npm i
• 重建： npm run build

测试本地构建

• 构建完成后，测试服务器： npx . 或者 node build/index.js
• 检查可执行文件是否已正确创建： ls -la build/index.js

检查发布的工件

• 看看将会发布什么： npm pack --dry-run
• 检查包裹内容： npm pack && tar -xzf manus-mcp-*.tgz && cat package/package.json

参考文献

• Manus API 文档https://open.manus.ai/docs 翻译为中文是：https://open.manus.ai/文档（或：https://open.manus.ai/帮助文档）
• **MCP SDK（MCP软件开发工具包）**https://modelcontextprotocol.io/docs/sdks 的中文翻译可以是：“模型上下文协议的SDK文档”。不过，为了更流畅地表达，我们也可以将其意译为：“模型上下文协议的软件开发工具包（SDK）文档页面”
• **MCP建筑事务所（或MCP建筑设计公司）**https://modelcontextprotocol.io/docs/learn/architecture 的中文翻译是：“https://modelcontextprotocol.io/网站上的学习/架构文档”。不过，通常我们不会直接翻译网址，而是直接引用原网址，或者在需要说明时简要描述其内容，如“该网址指向Model Context Protocol的架构学习文档”。如果是在需要中文表述网址用途或内容的语境下，可以这样说
• MCP服务器概念https://modelcontextprotocol.io/docs/learn/server-concepts 翻译为中文是：“https://modelcontextprotocol.io/文档/学习/服务器概念”
• MCP服务器规范https://modelcontextprotocol.io/specification/2025-06-18/server/index 的中文翻译为：“https://modelcontextprotocol.io/规范/2025-06-18/服务器/索引” 或者更自然地表达为：“Model Context Protocol 规范网站中关于 2025 年 6 月 18 日服务器部分的索引页面”。不过，通常在中文语境下，网址本身不会被完整翻译，而是直接保留原样或简要说明其含义，如“Model Context Protocol 规范网站的 2025-06-18 版本服务器部分的索引页面”
• Manus 快速入门https://open.manus.ai/docs/quickstart 翻译为中文是：https://open.manus.ai/快速入门文档
• **Manus Webhooks（可译为“Manus的Webhooks”或根据上下文简化为“Manus钩子”）**https://open.manus.ai/docs/webhooks/overview 的中文翻译为：“https://open.manus.ai/docs/webhooks/概述”
• 曼努斯连接器https://open.manus.ai/docs/connectors/overview 的中文翻译为：“https://open.manus.ai/文档/连接器/概述”

名称一致性与故障排除

始终使用 规范ID (manus-mcp）用于标识符和密钥。使用 规范显示 (Manus MCP) 仅用于UI标签。注册后不要混合使用旧版密钥。

一致性矩阵

冲突清理

• 删除任何过时的密钥（例如，旧的显示名称如“Manus”），并重新添加 manus-mcp 仅
• 确保全球（范围/覆盖/一致性等，具体含义需根据上下文确定） .mcp.json 或客户端注册表仅使用 manus-mcp 用于钥匙
• 光标在用户界面中进行配置；此项目故意省略了 .cursor/mcp.json

示例

✅ 正确：

{
  "mcpServers": {
    "manus-mcp": {
      "command": "npx",
      "args": ["manus-mcp"]
    }
  }
}

❌（表示错误或否定） 错误:

{
  "mcpServers": {
    "Manus": {  // Wrong: will conflict with "manus-mcp"
      "command": "npx",
      "args": ["manus-mcp"]
    }
  }
}

许可证

麻省理工学院（MIT）