mirror of
https://github.com/hanzoai/mcp.git
synced 2026-10-15 12:30:12 +00:00
zeekay
075661c92e
Major Features: - Complete GitHub API integration for fetching UI components - Support for 5 frameworks: Hanzo (default), React, Svelte, Vue, React Native - 13 new MCP tools for comprehensive UI component management - Full parity with shadcn-ui-mcp-server functionality New Tools: - ui_get_component - Fetch component source code - ui_get_component_demo - Get component usage examples - ui_get_component_metadata - Extract dependencies and registry info - ui_list_components - List all available components - ui_get_block - Fetch UI blocks (complex compositions) - ui_list_blocks - List blocks with categories - ui_get_directory_structure - Browse repository structure - ui_set_framework - Switch between frameworks - ui_get_framework - Get current framework - ui_set_github_token - Configure GitHub authentication - ui_get_rate_limit - Check API rate limit status Framework Support: - Hanzo UI (hanzoai/ui) - Default framework - React/shadcn (shadcn-ui/ui) - Svelte (huntabyte/shadcn-svelte) - Vue (unovue/shadcn-vue) - React Native (founded-labs/react-native-reusables) Technical Improvements: - GitHub API client with rate limiting and caching - Circuit breaker pattern for resilience - 15-minute cache TTL for API responses - Automatic authentication detection - Support for blocks with multiple files - Tree view directory browsing
@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