Manus MCP

🚀 Manus MCP

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

🚀 Quick Start

Using with Claude for Desktop

To use Manus MCP in 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 in Claude for Desktop.

✨ Features

• "google_search" tool: Performs a Google search and returns relevant links.
• "browse_web" tool: Allows browsing websites, clicking elements, and extracting content.
• "code_interpreter" tool: Can read, write, and execute code in a sandbox environment.
• "bash_tool" tool: Can run shell commands in the sandbox directory.

💻 Usage Examples

Available Tools

hello_world

A simple greeting tool that returns a welcome message.

google_search

Performs a Google search and returns a list of relevant links.

browse_web

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

• navigate: Visit 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 sandbox environment. Supported operations:

• read: Read the content of a file.
• write: Write content to a file.
• execute: Execute a file or a code snippet.
• list: List the 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 the foreground or background.
• Configure environment variables such as PATH.
• Execute complex shell scripts.

📦 Installation

Prerequisites

• Install Python 3.8 or higher.
• Install the pip tool.
• Be familiar with command-line operations and basic development environment configuration.

Steps

1. Clone the project repository:

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

2. Create and activate a virtual environment (it is recommended to use venv):

   python -m venv env
   source env/bin/activate  # Use `env\Scripts\activate` on Windows
   

3. Install the dependencies:

   pip install -r requirements.txt
   

4. Configure the environment variables, for example, by editing the config.py file.

5. Start the server:

   python mcp_server.py
   

📚 Documentation

Environment Variables

API Documentation

Please refer to the official documentation for detailed API interfaces and usage instructions.

📄 License

This project is licensed under the MIT License. Please see the LICENSE file for details.