Manus MCP 服务器使用说明

项目简介

Manus MCP 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在增强大型语言模型（LLM）的功能。它通过提供一系列工具，如网页浏览、Google 搜索和代码解释器，使 LLM 能够访问实时信息、执行外部操作，从而更有效地完成复杂任务。

主要功能点

工具 (Tools) 丰富：
- 'google_search': 利用 Google 搜索引擎进行信息检索，返回相关链接，帮助 LLM 获取最新的网络信息。
- 'browse_web': 模拟浏览器行为，允许 LLM 浏览网页、点击元素、提取内容和执行 JavaScript，实现网页内容的深度交互和理解。
- 'code_interpreter': 提供代码沙箱环境，支持多种编程语言（Python, JavaScript, Bash 等）的代码执行，使 LLM 具备编程能力，可用于数据分析、脚本编写等任务。
- 'bash_tool': 允许 LLM 在沙箱环境中执行 Bash 命令，进行文件管理、进程控制等操作，进一步扩展了 LLM 的系统交互能力。
- 'hello_world': 一个简单的问候工具，用于测试服务器连接和工具调用。
- 'manus_identity': 在对话开始时自动调用的工具，用于声明 Manus MCP 的身份和能力，引导 LLM 正确使用工具。
环境隔离：代码解释器和 Bash 工具在沙箱环境中运行，保障安全性和隔离性。
可配置性：通过环境变量可以灵活配置沙箱目录、超时时间、浏览器模式、搜索结果数量和日志级别等参数。
API 文档：提供符合 MCP 协议的 API 文档，方便开发者理解和集成。

安装步骤

环境准备：
- 确保已安装 Python 3.11 或更高版本。
- 推荐安装 'uv'，一个快速的 Python 包管理器 (参考 uv)。

克隆仓库：

git clone https://github.com/huyouare/manus-mcp.git
cd manus-mcp

安装依赖：

推荐使用 setup 脚本 (简化安装):
```
./setup.sh
```

或者手动安装：

uv venv
source .venv/bin/activate  # 激活虚拟环境
uv pip install -e .

启动服务器：
- 确保已激活虚拟环境 ('source .venv/bin/activate')
- 运行 'run.py' 脚本：
```
./run.py
```
- 或者使用 'uvicorn' 命令：
```
uvicorn app.main:app --reload
```
- 服务器默认在 'http://127.0.0.1:8000' 启动。访问 'http://localhost:8000/docs' 可以查看 API 文档。

服务器配置

Manus MCP 服务器需要 MCP 客户端（例如 Claude for Desktop）通过配置连接。以下是 Claude for Desktop 的配置示例，其他 MCP 客户端的配置方式类似，需要配置服务器启动命令及其参数。

Claude for Desktop 配置 ( 'claude_desktop_config.json' ) 示例：

{
  "mcpServers": {
    "manus-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/manus-mcp",  // 替换为 manus-mcp 仓库的绝对路径
        "run",
        "mcp_server.py"
      ]
    }
  }
}

配置参数说明：

'"manus-mcp"': 服务器名称，可以自定义。
'"command"': 启动服务器的命令，这里使用 'uv'，也可以根据实际安装情况使用 'python' 或其他命令。
'"args"': 命令参数列表：
- '"--directory"': 指定工作目录为 manus-mcp 仓库的绝对路径，请务必替换 '/ABSOLUTE/PATH/TO/manus-mcp' 为你本地仓库的实际绝对路径。
- '"run"': 执行 'run.py' 脚本。
- '"mcp_server.py"': 如果使用 'python' 命令启动，则可以改为 'python mcp_server.py'。

环境变量配置：

Manus MCP 服务器还支持通过环境变量进行配置，可以在运行服务器之前设置以下环境变量：

'SANDBOX_DIR': 沙箱目录路径，默认为 '~/manus-sandbox'。
'GLOBAL_TIMEOUT': 全局操作超时时间（秒），默认为 '60' 秒。
'BROWSER_HEADLESS': 浏览器是否以无头模式运行，默认为 'false' (显示界面)。设置为 'true' 则在后台运行。
'GOOGLE_SEARCH_MAX_RESULTS': Google 搜索返回的最大结果数，默认为 '10'。
'LOG_LEVEL': 日志级别，默认为 'INFO'。

基本使用方法

启动 Manus MCP 服务器 (参考安装步骤)。
配置 MCP 客户端 (参考服务器配置)，将客户端指向 Manus MCP 服务器。
在 MCP 客户端中，即可调用 Manus MCP 服务器提供的工具，例如：
- 使用 'google_search' 工具进行网络搜索。
- 使用 'browse_web' 工具浏览和操作网页。
- 使用 'code_interpreter' 工具执行代码。
- 使用 'bash_tool' 工具执行 shell 命令。

具体工具的使用方法请参考仓库 'README.md' 文件中 "Available Tools" 部分的详细描述。

关键词