# Manus MCP

<p align="center">
  <img src="meme.jpeg" alt="Manus MCP" width="50%">
</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:
   ```json
   {
     "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](https://github.com/astral-sh/uv) - Fast Python package installer and resolver

### Installation

#### Using Setup Script (Recommended)

```bash
./setup.sh
```

#### Manual Installation

1. Clone the repository
   ```bash
   git clone https://github.com/yourusername/manus-mcp.git
   cd manus-mcp
   ```

2. Create a virtual environment and install dependencies
   ```bash
   uv venv
   source .venv/bin/activate
   uv pip install -e .        # Install the project and its dependencies
   ```

3. Run the server
   ```bash
   # 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:

```bash
uv pip install -e ".[dev]"
```

### API Documentation

The API follows the [Model Context Protocol (MCP) specification](https://modelcontextprotocol.io/).

## License

[MIT](LICENSE)