Manus MCP

Manus MCP

一个 Model Context Protocol（MCP）服务实现，支持浏览网页、执行搜索查询和运行代码。

当前功能

• "google_search" 工具，可执行 Google 搜索并返回相关链接
• "browse_web" 工具，可浏览网站、点击元素并提取内容
• "code_interpreter" 工具，可在沙箱环境中读取、编写和执行代码
• "bash_tool" 工具，可在沙箱目录中运行 shell 命令

与 Claude for Desktop 搭配使用

要将 Manus MCP 与 Claude for Desktop 搭配使用：

1. 创建或编辑 Claude for Desktop 配置文件：

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json

2. 添加以下配置：

   {
     "mcpServers": {
       "manus-mcp": {
         "command": "uv",
         "args": [
           "--directory",
           "/ABSOLUTE/PATH/TO/manus-mcp",
           "run",
           "mcp_server.py"
         ]
       }
     }
   }
   

3. 重启 Claude for Desktop

4. 现在，你应该可以在 Claude for Desktop 中看到 Manus MCP 工具

可用工具

hello_world

一个简单的问候工具，可返回欢迎消息。

google_search

执行 Google 搜索并返回相关链接列表。

browse_web

通过网页浏览器浏览网站并提取信息。支持以下操作：

• navigate：访问指定 URL
• click：按索引点击元素
• input_text：在元素中输入文本
• get_content：获取页面内容
• execute_js：执行 JavaScript 代码
• scroll：滚动页面
• refresh：刷新当前页面

code_interpreter

可在沙箱环境中读取、编写和执行代码文件。支持以下操作：

• read：读取文件内容
• write：向文件写入内容
• execute：执行文件或代码片段
• list：列出沙箱中的文件

支持多种编程语言，包括 Python、JavaScript（Node.js）、Bash、Ruby、Perl 和 R。

bash_tool

在沙箱目录中执行 bash 命令。功能包括：

• 在前台或后台模式下运行命令
• 启动 Web 服务和其他长时间运行的进程
• 安装软件包和依赖项
• 管理文件和进程

环境变量

可以配置以下环境变量：

• SANDBOX_DIR：沙箱目录的路径（默认值：~/manus-sandbox）
• GLOBAL_TIMEOUT：所有操作的全局超时时间，单位为秒（默认值：60）
• BROWSER_HEADLESS：是否以无头模式运行浏览器（默认值：false）
• GOOGLE_SEARCH_MAX_RESULTS：要返回的搜索结果数量上限（默认值：10）
• LOG_LEVEL：日志级别（默认值：INFO）

开发指南

前置条件

• Python 3.11+
• uv - 快速的 Python 软件包安装器和解析器

安装

使用设置脚本（推荐）

./setup.sh

手动安装

1. 克隆代码仓库

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

2. 创建虚拟环境并安装依赖项

   uv venv
   source .venv/bin/activate
   uv pip install -e .        # Install the project and its dependencies
   

3. 运行服务

   # Make sure your virtual environment is activated
   source .venv/bin/activate
   ./run.py
   # or
   uvicorn app.main:app --reload
   

4. 访问 http://localhost:8000/docs 查看 API 文档

开发依赖项

要安装开发依赖项：

uv pip install -e ".[dev]"

API 文档

API 遵循 Model Context Protocol（MCP）规范。

许可证

MIT