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:
- Create or edit the Claude for Desktop configuration file:
* macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
Add the following configuration:
{
"mcpServers": {
"manus-mcp": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/manus-mcp",
"run",
"mcp_server.py"
]
}
}
}
Restart Claude for Desktop
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
Clone the repository
git clone https://github.com/yourusername/manus-mcp.git
cd manus-mcp
Create a virtual environment and install dependencies
uv venv
source .venv/bin/activate
uv pip install -e . # Install the project and its dependencies
Run the server
Make sure your virtual environment is activated
source .venv/bin/activate
./run.py
# or
uvicorn app.main:app --reload
- 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