The Hanzo MCP server is a universal development tool enabling Claude to interact with projects through advanced code understanding, modification, and management capabilities.
Universal Development Operations: Use the
devtool to perform file operations, execute commands, analyze projects, manage notebooks, and interact with vector stores.Code Understanding & Modification: Read, create, modify, and edit files and their content within repositories.
Complex Reasoning: Leverage the
thinktool for brainstorming and analysis without making repository changes.Server Management: Control MCP servers with
run_mcp(list, start, stop, restart) and manage external servers (list, enable, disable).Auto-Detection Configuration: Toggle auto-detection of external servers.
Sub-Agent Delegation: Assign tasks to concurrent sub-agents for efficient processing.
Supports code discovery and project analysis, enabling understanding of project structure, dependencies, and frameworks in Git repositories
Enables reading and editing Jupyter notebooks with full cell and output handling capabilities
Provides enhanced command execution in shell environments with improved error handling and security controls
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Hanzo MCPlist all UI components in my current project"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@hanzo/mcp
Model Context Protocol (MCP) server with HIP-0300 unified tool architecture. TypeScript + Rust dual runtime.
Installation
npm install -g @hanzo/mcpRelated MCP server: Claude-LMStudio Bridge
Quick Start
# Start with unified tools (default: 13 HIP-0300 tools)
hanzo-mcp serve
# Legacy individual tools
hanzo-mcp serve --legacy
# With UI extensions
hanzo-mcp serve --enable-ui
# List available tools
hanzo-mcp list-tools
# Install for Claude Desktop
hanzo-mcp install-desktopHIP-0300 Tool Surface
13 canonical tools organized by axis. Each tool uses action-routed dispatch.
Core Tools (7)
Tool | Axis | Key Actions |
| Bytes + Paths | read, write, stat, list, mkdir, rm, mv, apply_patch, search_text |
| Execution | run, background, ps, kill, logs |
| Symbols + Semantics | parse, search, transform, summarize |
| Diffs + History | status, diff, log, commit, branch, stash |
| HTTP/API | get, post, put, delete, download |
| Project Context | info, config, env, dependencies |
| UI Components | list_components, fetch_component, search, install |
Optional Tools (6)
Tool | Purpose |
| Structured reasoning |
| Persistent storage |
| Hanzo platform API (iam, kms, paas, commerce) |
| Task planning |
| Task tracking |
| Developer modes |
Usage
CLI Options
# Default: HIP-0300 unified surface (13 tools)
hanzo-mcp serve
# Legacy individual tools (read_file, write_file, bash, etc.)
hanzo-mcp serve --legacy
# Enable UI extensions
hanzo-mcp serve --enable-ui --enable-desktop
# Disable specific tools
hanzo-mcp serve --disable-tools plan,tasksProgrammatic Usage
import { getConfiguredTools } from '@hanzo/mcp';
// HIP-0300 unified surface (default)
const tools = getConfiguredTools({ unified: true });
// Legacy individual tools
const tools = getConfiguredTools({ enableLegacy: true });
// With UI extensions
const tools = getConfiguredTools({
unified: true,
enableUI: true,
enableDesktop: true,
});AI Client Configuration
Claude Desktop / Cursor
Add to .mcp.json:
{
"mcpServers": {
"hanzo": {
"command": "npx",
"args": ["@hanzo/mcp", "serve"]
}
}
}Architecture
src/tools/unified/ # HIP-0300 action-routed tools (fs, exec, code, fetch, workspace, hanzo)
src/tools/ # Individual tools (git, think, memory, tasks, plan, mode, etc.)
rust/src/tools/ # Rust native tools (exec, git, fetch, code, computer, etc.)The Rust runtime provides native performance for latency-sensitive operations (<5ms clicks, <2ms keypress, <50ms screenshots).
Python SDK Parity
The Python implementation (hanzo-mcp on PyPI) exposes the same 13 HIP-0300 tools via entry-point discovery from hanzo-tools-* packages. Tool names and action schemas are identical across both runtimes.
pip install hanzo-mcpLicense
MIT
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.