Manus MCP

<p align="center">

</p>

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