@hanzo/mcp

统一模型上下文协议（MCP）服务器，提供全面的AI开发工具和UI组件管理。

安装

npm install -g @hanzo/mcp

快速开始

# 启动所有工具（默认：54个工具）
hanzo-mcp serve

# 只启动核心工具（19个工具）
hanzo-mcp serve --core-only

# 禁用特定工具类别
hanzo-mcp serve --disable-ui             # 排除UI工具
hanzo-mcp serve --disable-autogui        # 排除AutoGUI工具
hanzo-mcp serve --disable-orchestration  # 排除编排工具

# 列出所有可用工具（默认54个）
hanzo-mcp list-tools

# 在Claude桌面安装
hanzo-mcp install-desktop

功能

核心工具（19个工具）

• 文件操作：读取、写入、列出、创建、删除、移动文件
• 搜索：Grep、查找文件、统一搜索策略
• 编辑：单次和多次编辑操作
• Shell：命令执行、后台进程

UI工具（11个工具，默认启用）

使用--disable-ui标志禁用：

• 组件管理：列出、搜索并获取组件详情
• 源码访问：检索组件源码和示例
• 项目设置：使用Hanzo UI初始化项目
• 块与模式：访问UI块和模式
• 安装指南：完整的设置文档

AutoGUI工具（18个工具，默认启用）

使用--disable-autogui标志禁用：

• 鼠标控制：移动、点击、拖拽、滚动操作
• 键盘控制：输入文本、按键、快捷键组合
• 屏幕捕获：截图、像素颜色检测
• 图像识别：在屏幕上找到匹配度高的图像
• 窗口管理：列出、激活、控制窗口
• 多显示器支持：屏幕信息和坐标

编排工具（6个工具，默认启用）

使用--disable-orchestration标志禁用：

• 代理生成：创建具有特定模型和约束条件的AI代理
• 群组编排：协调多个代理进行并行或顺序操作
• 批评代理：代码审查和质量门禁
• Hanzo节点：连接到分布式AI计算节点
• LLM路由：智能模型选择和回退链
• 共识机制：多代理投票和决策

使用方法

命令行选项

# 启动所有工具（默认 - 54个工具）
hanzo-mcp serve

# 只启动核心工具（19个工具）
hanzo-mcp serve --core-only

# 禁用特定类别
hanzo-mcp serve --disable-ui --disable-autogui --disable-orchestration

# 自定义工具选择
hanzo-mcp serve --enable-categories files,ui --disable-tools bash,shell

# 按类别列出工具
hanzo-mcp list-tools --category ui

程序化使用

import { createMCPServer } from '@hanzo/mcp';

// 基本服务器，包含核心工具
const server = await createMCPServer();

// 启用了UI工具的服务器
const serverWithUI = await createMCPServer({
  toolConfig: {
    enableCore: true,
    enableUI: true
  }
});

// 自定义配置
const customServer = await createMCPServer({
  name: 'my-mcp-server',
  version: '1.0.0',
  toolConfig: {
    enableCore: true,
    enableUI: true,
    enableAutoGUI: true,
    enableOrchestration: true,
    disabledTools: ['bash'],
    customTools: [/* 自定义工具 */]
  }
});

AI客户端配置

Claude桌面

添加到.mcp.json：

{
  "mcpServers": {
    "hanzo": {
      "command": "npx",
      "args": ["@hanzo/mcp", "serve"]
    }
  }
}

Cursor

添加到.cursor/mcp.json：

{
  "mcpServers": {
    "hanzo": {
      "command": "npx",
      "args": ["@hanzo/mcp", "serve"]
    }
  }
}

特性

• 模块化工具系统：仅启用所需的工具（总共54个工具）
• 代理编排：生成和协调多个AI代理
• 共识机制：多代理决策和投票
• 批评系统：自动代码审查和质量保证
• LLM路由：智能模型选择和回退链
• UI组件集成：访问Hanzo UI组件和模式
• 计算机控制：完整的鼠标、键盘和屏幕自动化
• 文件系统操作：全面的文件操作
• 代码执行：安全的Shell命令执行
• 搜索能力：多种搜索策略
• 分布式计算：连接到Hanzo计算节点
• 多实现支持：RustAutoGUI、JSAutoGUI、PyAutoGUI，自动回退
• 可扩展架构：轻松添加自定义工具
• AI客户端集成：与Claude、Cursor和其他MCP客户端兼容

许可证

MIT © Hanzo AI