Manus MCP

A Model Context Protocol (MCP) server implementation that can browse the web, perform search queries, and execute code.

Current Features

• "google_search" tool that performs Google searches and returns relevant links
• "browse_web" tool that allows browsing websites, clicking elements, and extracting content
• "code_interpreter" tool that allows reading, writing, and executing code in a sandbox environment
• "bash_tool" tool that allows running shell commands in the sandbox directory

Using with Claude for Desktop

To use Manus MCP with Claude for Desktop:

1. Create or edit the Claude for Desktop configuration file:

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

2. Add the following configuration:

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

3. Restart Claude for Desktop

4. You should now see the Manus MCP tools available in Claude for Desktop

Available Tools

hello_world

A simple greeting tool that returns a welcome message.

google_search

Performs Google searches and returns a list of relevant links.

browse_web

Interacts with a web browser to navigate websites and extract information. Supported actions:

• navigate: Go to a specific URL
• click: Click an element by index
• input_text: Input text into an element
• get_content: Get the page content
• execute_js: Execute JavaScript code
• scroll: Scroll the page
• refresh: Refresh the current page

code_interpreter

Allows reading, writing, and executing code files in a sandboxed environment. Supported actions:

• read: Read the contents of a file
• write: Write content to a file
• execute: Execute a file or code snippet
• list: List files in the sandbox

Supports multiple programming languages including Python, JavaScript (Node.js), Bash, Ruby, Perl, and R.

bash_tool

Executes bash commands in the sandbox directory. Features:

• Run commands in foreground or background mode
• Start web servers and other long-running processes
• Install packages and dependencies
• Manage files and processes

Environment Variables

The following environment variables can be configured:

• SANDBOX_DIR: Path to the sandbox directory (default: ~/manus-sandbox)
• GLOBAL_TIMEOUT: Global timeout for all operations in seconds (default: 60)
• BROWSER_HEADLESS: Whether to run the browser in headless mode (default: false)
• GOOGLE_SEARCH_MAX_RESULTS: Maximum number of search results to return (default: 10)
• LOG_LEVEL: Logging level (default: INFO)

Development Guide

Prerequisites

• Python 3.11+
• uv - Fast Python package installer and resolver

Installation

Using Setup Script (Recommended)

./setup.sh

Manual Installation

1. Clone the repository

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

2. Create a virtual environment and install dependencies

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

3. Run the server

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

4. Visit http://localhost:8000/docs to see the API documentation

Development Dependencies

To install development dependencies:

uv pip install -e ".[dev]"

API Documentation

The API follows the Model Context Protocol (MCP) specification.

License

MIT