Model Context Protocol server with 260+ tools for AI agents
概览
The official server for coding agents, autonomous workflows, and tool orchestration. It exposes 260+ capabilities collapsed into high-efficiency action-routed tools over or streamable (--transport http), plus native integration with the . Hanzo Dev (dev.chat) comes pre-wired with @hanzo/mcp by default. You can also attach custom server flags: Add to your mcpServers configuration (~/.cursor/mcp.json or project .mcp.json): For remote or multi-agent deployments, serve over HTTP with Server-Sent Events: POST JSON-RPC requests to http://127.0.0.1:3000/ with header Accept: application/json, text/event-stream. Running serve with default flags registers the complete action-routed tool catalog defined in src/tools/unified/index.ts: The unified hanzo tool gives agents access to all 2,400+ endpoints across the Hanzo Cloud platform: - resource: Names the subsystem (e.g., models, graph, iam, kms, billing, chain, network). - action: Names the operation.
README
以下为原文 README 节选，完整内容请查看原文。
@hanzo/mcp
The official Model Context Protocol (MCP) server for coding agents, autonomous workflows, and tool orchestration.
It exposes 260+ capabilities collapsed into high-efficiency action-routed tools over stdio or streamable HTTP/SSE (--transport http), plus native integration with the Kai Agent Governance & Decision Engine.
Quick Setup & Client Configuration
The package requires Node 18 or newer.
1. Claude Code
Register globally for all projects:
npx -y @hanzo/mcp install --claude-code
# or manually:
claude mcp add --scope user hanzo -- npx -y @hanzo/mcp serve
Verify with:
claude mcp list
# reports: hanzo: npx -y @hanzo/mcp serve - ✔ Connected
2. Hanzo Dev (hanzo dev)
Hanzo Dev (dev.chat) comes pre-wired with @hanzo/mcp by default. You can also attach custom server flags:
hanzo dev
# or within any repo session:
/mcp add hanzo -- npx -y @hanzo/mcp serve
3. Cursor, Windsurf, Zed, and VS Code
Add to your mcpServers configuration (~/.cursor/mcp.json or project .mcp.json):
{
"mcpServers": {
"hanzo": {
"command": "npx",
"args": ["-y", "@hanzo/mcp", "serve"],
"env": {
"HANZO_API_KEY": "sk-..."
}
}
}
}
4. Over Streamable HTTP (SSE)
For remote or multi-agent deployments, serve over HTTP with Server-Sent Events:
npx -y @hanzo/mcp serve --transport http --port 3000
POST JSON-RPC requests to http://127.0.0.1:3000/ with header Accept: application/json, text/event-stream.
Tool Catalog
Running serve with default flags registers the complete action-routed tool catalog defined in src/tools/unified/index.ts:
| Group | Tools | Description |
|---|---|---|
| core | fs, exec, code, git, fetch, workspace, ui |
File read/write, shell execution, AST code edits, git operations, HTTP calls, UI components. |
| optional | think, memory, hanzo, plan, tasks, mode, gimp |
CoT scratchpads, semantic memory, Hanzo Cloud resource dispatch, task coordination, canvas. |
| code intelligence | code_search, code_context, code_ask, code_index |
Dense vector code search, symbol index lookup, context graph resolution. |
| tracker | tracker_boards, tracker_issues, tracker_create, tracker_update |
Visible engineering work items and live session status tracking on hanzo.app. |
安装
npx -y @hanzo/mcp serve配置
{
"mcpServers": {
"hanzo": {
"command": "npx",
"args": ["-y", "@hanzo/mcp", "serve"],
"env": {
"HANZO_API_KEY": "sk-..."
}
}
}
}