使用说明

ManusMCP 是一个基于 Model Context Protocol (MCP) 的 AI Agent 框架,旨在通过标准化的 MCP 协议,为 LLM 客户端提供丰富的上下文信息和功能,从而支持 AI Agent 协同完成复杂任务。

主要功能点:

  • 资源访问 (Resources): 提供文件系统操作能力,包括读取、写入、查找文件内容和名称,以及读取图片文件。
  • 工具调用 (Tools):
    • Shell 命令执行: 允许 AI Agent 执行 Shell 命令,管理进程,并支持交互式 Shell 会话。
    • 浏览器自动化: 提供网页浏览和交互能力,包括页面导航、元素点击、文本输入、鼠标移动、按键模拟、选项选择、页面滚动、执行 JavaScript 代码以及查看控制台日志和屏幕截图。
  • Prompt 模板 (Prompts): 仓库主要关注工具的实现,Prompt 模板可能需要在 Flowise UI 中配置,具体可参考 Flowise 的 Agentflows 功能。
  • 多 Agent 协同: 框架设计用于编排多个具有专门技能的 AI Agent (Planner, FileWizard, CommandRunner, WebNavigator) 协同工作。

安装步骤:

  1. 克隆仓库:

    git clone https://github.com/mantrakp04/manusmcp.git
    cd manusmcp
  2. 安装 Bun: 如果尚未安装 Bun,请先安装 Bun 包管理器 (https://bun.sh/)。可以使用 npm 安装:

    npm install -g bun
  3. 安装依赖并启动 Docker:

    cd manusmcp/.runtime
    bun i # 安装依赖
    cd ..
    cp .env.example .env # 可选:复制并配置 .env 文件,如果需要
    docker-compose up -d # 使用 Docker Compose 启动服务
  4. 导入 Flowise AgentFlow (可选):

    • 打开 Flowise UI,地址通常为 http://localhost:8001
    • 进入 "Agentflows" 部分。
    • 点击右上角的 "Settings" (设置) 按钮。
    • 点击 "Import" (导入) 并选择仓库根目录下的 'flow.json' 文件,导入预配置的 AgentFlow。
  5. [可选] 运行 MCP Server Inspector: 用于调试和检查 MCP Server 运行状态。

    cd .runtime
    bunx @modelcontextprotocol/inspector bun index.ts

服务器配置 (MCP 客户端配置):

MCP 客户端需要配置以下 JSON 信息以连接到 ManusMCP 服务器:

{
  "serverName": "ManusMCP",
  "command": "bun",
  "args": ["index.ts"],
  "transport": "stdio"
}

配置参数说明:

  • 'serverName': MCP 服务器的名称,设置为 "ManusMCP"。
  • 'command': 启动 MCP 服务器的命令,这里使用 'bun' 运行时。
  • 'args': 传递给启动命令的参数,指定服务器入口文件为 'index.ts'。
  • 'transport': 指定通信传输协议,这里使用 'stdio' (标准输入输出)。

基本使用方法:

  1. 启动 ManusMCP 服务器 (按照安装步骤操作)。
  2. 配置 MCP 客户端,将上述 JSON 配置信息填入 MCP 客户端的服务器配置中,确保客户端能够通过 stdio 与 ManusMCP 服务器通信。
  3. 在 Flowise UI 中 (如果导入了 'flow.json'),可以查看和编辑预配置的 AgentFlow,这些 AgentFlow 利用 ManusMCP 提供的工具进行协同工作。
  4. 通过 MCP 客户端,可以向 ManusMCP 服务器发送 MCP 请求 (例如调用 'file_read', 'shell_exec', 'browser_navigate' 等工具),以实现各种功能。

注意: ManusMCP 主要使用 Flowise 进行 Agent 流程编排,并强调与 Anthropic 模型的兼容性。

信息

分类

AI与计算