hanzoai/mcp
3.4
If you are the rightful owner of mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
An implementation of Hanzo capabilities using the Model Context Protocol (MCP).
Tools
15
Resources
0
Prompts
0
@hanzo/mcp
Unified Model Context Protocol (MCP) server providing comprehensive AI development tools and UI component management.
Installation
npm install -g @hanzo/mcp
Quick Start
# Start with all tools enabled (default: 54 tools)
hanzo-mcp serve
# Core tools only (19 tools)
hanzo-mcp serve --core-only
# Disable specific tool categories
hanzo-mcp serve --disable-ui # Exclude UI tools
hanzo-mcp serve --disable-autogui # Exclude AutoGUI tools
hanzo-mcp serve --disable-orchestration # Exclude orchestration tools
# List all available tools (54 by default)
hanzo-mcp list-tools
# Install for Claude Desktop
hanzo-mcp install-desktop
Features
Core Tools (19 tools)
- File Operations: Read, write, list, create, delete, move files
- Search: Grep, find files, unified search strategies
- Editing: Single and multi-edit operations
- Shell: Command execution, background processes
UI Tools (11 tools - enabled by default)
Disable with --disable-ui flag:
- Component Management: List, search, and get component details
- Source Code Access: Retrieve component source and demos
- Project Setup: Initialize projects with Hanzo UI
- Blocks & Patterns: Access UI blocks and patterns
- Installation Guides: Complete setup documentation
AutoGUI Tools (18 tools - enabled by default)
Disable with --disable-autogui flag:
- Mouse Control: Move, click, drag, scroll operations
- Keyboard Control: Type text, press keys, hotkey combinations
- Screen Capture: Screenshots, pixel color detection
- Image Recognition: Find images on screen with confidence matching
- Window Management: List, activate, control windows
- Multi-monitor Support: Screen information and coordinates
Orchestration Tools (6 tools - enabled by default)
Disable with --disable-orchestration flag:
- Agent Spawning: Create AI agents with specific models and constraints
- Swarm Orchestration: Coordinate multiple agents in parallel or sequence
- Critic Agents: Code review and quality gate enforcement
- Hanzo Node: Connect to distributed AI compute nodes
- LLM Router: Intelligent model selection and fallback chains
- Consensus: Multi-agent voting and decision making
Usage
CLI Options
# All tools enabled (default - 54 tools)
hanzo-mcp serve
# Core tools only (19 tools)
hanzo-mcp serve --core-only
# Disable specific categories
hanzo-mcp serve --disable-ui --disable-autogui --disable-orchestration
# Custom tool selection
hanzo-mcp serve --enable-categories files,ui --disable-tools bash,shell
# List tools by category
hanzo-mcp list-tools --category ui
Programmatic Usage
import { createMCPServer } from '@hanzo/mcp';
// Basic server with core tools
const server = await createMCPServer();
// Server with UI tools enabled
const serverWithUI = await createMCPServer({
toolConfig: {
enableCore: true,
enableUI: true
}
});
// Custom configuration
const customServer = await createMCPServer({
name: 'my-mcp-server',
version: '1.0.0',
toolConfig: {
enableCore: true,
enableUI: true,
enableAutoGUI: true,
enableOrchestration: true,
disabledTools: ['bash'],
customTools: [/* your tools */]
}
});
AI Client Configuration
Claude Desktop
Add to .mcp.json:
{
"mcpServers": {
"hanzo": {
"command": "npx",
"args": ["@hanzo/mcp", "serve"]
}
}
}
Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"hanzo": {
"command": "npx",
"args": ["@hanzo/mcp", "serve"]
}
}
}
Features
- Modular Tool System: Enable only the tools you need (54 tools total)
- Agent Orchestration: Spawn and coordinate multiple AI agents
- Consensus Mechanisms: Multi-agent decision making and voting
- Critic System: Automated code review and quality enforcement
- LLM Routing: Intelligent model selection with fallback chains
- UI Component Integration: Access Hanzo UI components and patterns
- Computer Control: Full mouse, keyboard, and screen automation
- File System Operations: Comprehensive file manipulation
- Code Execution: Safe shell command execution
- Search Capabilities: Multiple search strategies
- Distributed Computing: Connect to Hanzo compute nodes
- Multi-Implementation Support: RustAutoGUI, JSAutoGUI, PyAutoGUI with automatic fallback
- Extensible Architecture: Add custom tools easily
- AI Client Integration: Works with Claude, Cursor, and other MCP clients
License
MIT © Hanzo AI
