Hanzo

by hanzoai

4 stars

9.1k downloads

Not rated

GitHub

About

Enables secure interaction with codebases through tools for file operations, command execution, project analysis, and Jupyter notebook management with path validation and operation allowlisting

Details

Author: hanzoai
Repository: hanzoai/mcp
GitHub stars: 4
Downloads: 9,100
License: MIT License
Categories: Productivity, Developer Tools, Design, File Management, AI, Frontend, Project Management, Security
Tags: #data-science

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Hanzo

Command (node, npx, python, etc.) npx
Arguments
- Argument 1 -y
- Argument 2 --package=@hanzo/mcp
- Argument 3 hanzo-mcp
- Argument 4 serve
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "hanzo": {
            "env": {},
            "args": [
                "-y",
                "--package=@hanzo/mcp",
                "hanzo-mcp",
                "serve"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "hanzo": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "--package=@hanzo/mcp",
                "hanzo-mcp",
                "serve"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "hanzo": {
            "env": {},
            "args": [
                "-y",
                "--package=@hanzo/mcp",
                "hanzo-mcp",
                "serve"
            ],
            "command": "npx"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "hanzo": {
            "env": {},
            "args": [
                "-y",
                "--package=@hanzo/mcp",
                "hanzo-mcp",
                "serve"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "hanzo": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "--package=@hanzo/mcp",
                "hanzo-mcp",
                "serve"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "hanzo": {
            "env": {},
            "args": [
                "-y",
                "--package=@hanzo/mcp",
                "hanzo-mcp",
                "serve"
            ],
            "command": "npx"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "hanzo": {
            "env": {},
            "args": [
                "-y",
                "--package=@hanzo/mcp",
                "hanzo-mcp",
                "serve"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "hanzo": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "--package=@hanzo/mcp",
                "hanzo-mcp",
                "serve"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "hanzo": {
            "env": {},
            "args": [
                "-y",
                "--package=@hanzo/mcp",
                "hanzo-mcp",
                "serve"
            ],
            "command": "npx"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "hanzo": {
            "env": {},
            "args": [
                "-y",
                "--package=@hanzo/mcp",
                "hanzo-mcp",
                "serve"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "hanzo": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "--package=@hanzo/mcp",
                "hanzo-mcp",
                "serve"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "hanzo": {
            "env": {},
            "args": [
                "-y",
                "--package=@hanzo/mcp",
                "hanzo-mcp",
                "serve"
            ],
            "command": "npx"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "hanzo": {
            "env": {},
            "args": [
                "-y",
                "--package=@hanzo/mcp",
                "hanzo-mcp",
                "serve"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "hanzo": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "--package=@hanzo/mcp",
                "hanzo-mcp",
                "serve"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "hanzo": {
            "env": {},
            "args": [
                "-y",
                "--package=@hanzo/mcp",
                "hanzo-mcp",
                "serve"
            ],
            "command": "npx"
        }
    }
}

From the repository

npm install -g @hanzo/mcp
hanzo-mcp serve

`read`

Read data from a specified file or path.

`write`

Write data to a specified file or path.

`stat`

Retrieve metadata about a specified file or path.

`list`

List the contents of a specified directory.

`mkdir`

Create a new directory at the specified path.

`rm`

Remove a specified file or directory.

`mv`

Move or rename a specified file or directory.

`apply_patch`

Apply a patch to a specified file.

`search_text`

Search for specific text within files.

`run`

Execute a command in the specified environment.

`background`

Run a command in the background.

`ps`

List running processes.

`kill`

Terminate a running process.

`logs`

Retrieve logs for a specified process.

`parse`

Parse symbols and semantics from code.

`search`

Search for specific code within a codebase.

`transform`

Transform code from one format to another.

`summarize`

Summarize the functionality of code.

`status`

Get the current status of a Git repository.

`diff`

Show differences between commits or branches.

`log`

Retrieve commit logs from a Git repository.

`commit`

Commit changes to the Git repository.

`branch`

Create or manage branches in the Git repository.

`stash`

Stash changes in the Git repository.

`get`

Retrieve data from a specified HTTP endpoint.

`post`

Send data to a specified HTTP endpoint.

`put`

Update data at a specified HTTP endpoint.

`delete`

Remove data at a specified HTTP endpoint.

`download`

Download a file from a specified URL.

`info`

Get information about the current project.

`config`

Manage project configuration settings.

`env`

Get environment variables for the project.

`dependencies`

List project dependencies.

`list_components`

List available UI components.

`fetch_component`

Retrieve a specific UI component.

`search`

Search for specific UI components.

`install`

Install a specified UI component.

`think`

Perform structured reasoning tasks.

`memory`

Manage persistent storage.

`hanzo`

Interact with the Hanzo platform surface.

`plan`

Manage task planning activities.

`tasks`

Track tasks within the project.

`mode`

Switch between different developer modes.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "hanzo": {
            "env": {},
            "args": [
                "-y",
                "--package=@hanzo/mcp",
                "hanzo-mcp",
                "serve"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": [],
    "args": [
        "-y",
        "--package=@hanzo/mcp",
        "hanzo-mcp",
        "serve"
    ],
    "command": "npx"
}

Macos

{
    "env": [],
    "args": [
        "-y",
        "--package=@hanzo/mcp",
        "hanzo-mcp",
        "serve"
    ],
    "command": "npx"
}

Windows

{
    "env": [],
    "args": [
        "/c",
        "npx",
        "-y",
        "--package=@hanzo/mcp",
        "hanzo-mcp",
        "serve"
    ],
    "command": "cmd"
}

@hanzo/mcp

The canonical Model Context Protocol server for the Hanzo AI Cloud — one action-routed tool surface every Hanzo agent runs on.

[]()
[]()

Quick start

npm install -g @hanzo/mcp
hanzo-mcp serve

What this is

@hanzo/mcp is the canonical MCP server for the Hanzo platform. It collapses a 260+ tool catalog into 13 HIP-0300 action-routed tools (fs, exec, code, git, fetch, workspace, ui, plus optional think, memory, hanzo, plan, tasks, mode) served over the MCP stdio / streamable-http transports.

Every Hanzo agent speaks this same tool surface. The Python SDK (hanzo-mcp on PyPI) and the Rust crate (hanzo-mcp::brain) mirror it 1-to-1, so a tool name and its action schema are identical across all three runtimes.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

read

write

stat

list

mkdir

rm

mv

apply_patch

search_text

run

background

ps

kill

logs

parse

search

transform

summarize

status

diff

log

commit

branch

stash

get

post

put

delete

download

info

config

env

dependencies

list_components

fetch_component

search

install

think

memory

hanzo

plan

tasks

mode

Claude Desktop / Cursor

Linux

Macos

Windows

@hanzo/mcp

Quick start

What this is

Install

More like this

Time

Sentry

Github

Git

GitLab

Context 7

`read`

`write`

`stat`

`list`

`mkdir`

`rm`

`mv`

`apply_patch`

`search_text`

`run`

`background`

`ps`

`kill`

`logs`

`parse`

`search`

`transform`

`summarize`

`status`

`diff`

`log`

`commit`

`branch`

`stash`

`get`

`post`

`put`

`delete`

`download`

`info`

`config`

`env`

`dependencies`

`list_components`

`fetch_component`

`search`

`install`

`think`

`memory`

`hanzo`

`plan`

`tasks`

`mode`