📌Overview

Purpose: Manus MCP serves as a Model Context Protocol server implementation designed for web browsing, executing search queries, and running code in a controlled environment.

Overview: Manus MCP is a versatile server that integrates multiple tools enabling users to interact with web content, execute programming tasks, and run shell commands seamlessly. It operates within a sandbox for enhanced security and functionality.

Key Features:

"google_search" tool: Facilitates online queries to Google, retrieving and presenting relevant links for user reference.
"browse_web" tool: Enables navigation through websites, including actions like clicking elements, inputting text, and extracting page content, supporting an interactive browsing experience.
"code_interpreter" tool: Allows users to read, write, and execute code across various programming languages (Python, JavaScript, etc.) within a secure sandbox environment.
"bash_tool" tool: Provides the capability to execute bash commands, manage files, and install packages, making it suitable for development and testing purposes.

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
Web browsing tool that allows navigating websites, clicking elements, and extracting content
Code interpreter tool that allows reading, writing, and executing code in a sandbox environment
Bash 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: https://github.com/astral-sh/uv

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: https://modelcontextprotocol.io/

License

MIT