Manus MCP

<p align="center"> <img src="meme.jpeg" alt="Manus MCP" width="50%"> </p>

这是一个可以浏览网页、执行搜索查询和运行代码的模型上下文协议（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: 返回的最大搜索结果数量（默认：1_0）
• 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 .        # 安装项目及其依赖项
   

3. 运行服务器

   # 确保激活了虚拟环境
   source .venv/bin/activate
   ./run.py
   # 或者
   uvicorn app.main:app --reload
   

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

开发依赖项

要安装开发依赖项：

uv pip install -e ".[dev]"

API文档

API遵循模型上下文协议（MCP）规范。

许可证

MIT