| Name | hanzo-mcp JSON |
| Version |
0.7.0
JSON |
| download |
| home_page | None |
| Summary | The Zen of Hanzo MCP: One server to rule them all. The ultimate MCP that orchestrates all others. |
| upload_time | 2025-07-26 00:11:47 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.12 |
| license | MIT |
| keywords |
mcp
claude
hanzo
code
agent
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Hanzo AI - The Zen of Model Context Protocol
[](https://mcp.hanzo.ai)
[](https://pypi.org/project/hanzo-mcp/)
[](https://github.com/hanzoai/mcp/releases/latest/download/hanzo-mcp.dxt)
[](https://github.com/hanzoai/mcp/blob/main/LICENSE)
[](https://discord.gg/hanzoai)
## 🥷 The Complete AI Development Ecosystem via MCP
**One unified interface to orchestrate your entire development workflow.**
Hanzo AI is more than an MCP server—it's a comprehensive ecosystem of interconnected development tools designed for the AI era. From interactive notebooks with multi-language support to advanced debugging, from intelligent code search to multi-agent workflows, everything works together seamlessly through the Model Context Protocol.
```bash
# Install and rule your development world
uvx hanzo-mcp
# Or use our one-click Desktop Extension
# Download from releases and double-click to install
```
> **Note on Installation**: If uvx is not installed, Hanzo will automatically install it for you in your home directory. No manual setup required!
## 🌐 The Hanzo Ecosystem
### Integrated Development Environment
```mermaid
graph LR
A[Hanzo MCP] --> B[Interactive Notebooks]
A --> C[Code Intelligence]
A --> D[Multi-Agent System]
A --> E[Project Management]
B --> B1[Multi-Language REPL]
B --> B2[SoS Kernels]
B --> B3[Live Debugging]
C --> C1[LSP Integration]
C --> C2[AST Analysis]
C --> C3[Semantic Search]
D --> D1[Agent Networks]
D --> D2[Tool Orchestration]
D --> D3[Consensus Systems]
E --> E1[Git Integration]
E --> E2[Task Management]
E --> E3[Quality Control]
```
### 🎯 Why Hanzo AI?
**The Problem with Fragmented Tools**
- Install 10 different tools that don't talk to each other
- Context switching between interfaces kills productivity
- No unified way to orchestrate complex workflows
- Missing the power of tool composition
**The Hanzo Solution**
- **Unified Ecosystem**: 70+ tools that work together seamlessly
- **Intelligent Orchestration**: Tools that understand context and collaborate
- **Interactive Development**: From REPL to debugging in one interface
- **Quality Built-in**: Automated review, testing, and best practices
- **Extensible Platform**: Add any MCP server or custom tool
## 🚀 Core Capabilities
### 📓 Interactive Development Environment
#### Multi-Language Notebooks with SoS
```python
# Work with multiple languages in one notebook
notebook(
action="create",
path="analysis.ipynb",
kernels=["python3", "R", "javascript", "bash"]
)
# Write and execute code interactively
notebook(
action="write",
cell_type="code",
content="""
# Python cell
data = load_dataset()
processed = clean_data(data)
""",
kernel="python3"
)
# Step through execution line by line
notebook(
action="step",
cell_id="cell_123",
lines=[1, 2, 3] # Execute specific lines
)
# Read results and outputs
result = notebook(
action="read",
cell_id="cell_123",
include_outputs=True
)
# Launch debugger for interactive debugging
debugger(
notebook="analysis.ipynb",
cell_id="cell_123",
breakpoint=15
)
```
#### Interactive REPL Sessions
```python
# Start multi-language REPL
repl(
languages=["python", "javascript", "go"],
project_dir="/path/to/project",
share_context=True # Share variables between languages
)
# Execute code with full project context
repl.execute("""
import project_module
result = project_module.process()
""", language="python")
```
### 🧠 Advanced AI Tools
#### Multi-Agent Workflows
```python
# Delegate complex tasks to specialized agents
agent(
prompts=["Find all API endpoints", "Document each endpoint", "Generate OpenAPI spec"],
parallel=True # Run agents concurrently
)
# Get consensus from multiple LLMs
consensus(
prompt="Review this architecture decision",
providers=["openai", "anthropic", "google"],
threshold=0.8 # Require 80% agreement
)
```
#### Built-in Code Critic
```python
# Force high-quality standards with the critic tool
critic(
analysis="Review authentication implementation for security issues"
)
# The critic will:
# - Find potential bugs and edge cases
# - Ensure proper error handling
# - Verify test coverage
# - Check security implications
# - Suggest improvements
# - Enforce best practices
```
### 📝 Project Intelligence
#### Automatic Rules Discovery
```python
# Reads your project preferences automatically
rules() # Finds .cursorrules, .claude/code.md, etc.
# Understands your:
# - Coding standards
# - Project conventions
# - AI assistant preferences
# - Team guidelines
```
#### Unified Todo Management
```python
# Single tool for all task management
todo("Add authentication to API")
todo --action update --id abc123 --status in_progress
todo --action list --filter pending
```
### 🔍 Intelligent Code Intelligence
#### Unified Search Engine
```python
# One search to rule them all - automatically runs in parallel:
# - Text search with ripgrep
# - AST analysis for code structure
# - Vector search for semantic meaning
# - Git history search (integrated into git tool)
# - Symbol search with LSP
# - Memory search for past discussions
search("authentication flow")
```
#### Language Server Protocol (LSP) Integration
```python
# Full LSP support with jupyter-lsp integration
lsp(
action="initialize",
language="python",
project_dir="/path/to/project"
)
# Go to definition, find references, rename symbols
lsp.goto_definition("UserService.authenticate")
lsp.find_references("API_KEY")
lsp.rename_symbol("oldFunction", "newFunction")
# Get diagnostics and hover information
diagnostics = lsp.get_diagnostics("main.py")
info = lsp.hover("mysterious_function", line=42, col=15)
```
#### Git Integration (with built-in search)
```python
# All git operations in one tool
git("status")
git("diff", "--cached")
git("log", "--oneline", "-10")
# Git search is now part of the git tool
git("search", pattern="TODO", history=True)
git("blame", file="src/auth.py", line=42)
git("show", commit="abc123:src/main.py")
```
### 🎨 Palette System - Opinions Are Just Configurations
```python
# Don't like our defaults? Switch instantly
palette --action activate python # Python development focused
palette --action activate javascript # Node.js/React optimized
palette --action activate devops # Infrastructure tools
palette --action activate academic # Research & documentation
# Create your own workflow
palette_create(
name="my-workflow",
tools=["read", "write", "edit", "search", "critic", "agent"],
env_vars={"EDITOR": "nvim", "SEARCH": "ripgrep"}
)
```
### 🔌 MCP Server Orchestration
```python
# Add any MCP server dynamically
mcp --action add --url "github.com/someone/their-mcp" --alias "their"
# Use their tools seamlessly
their_tool(action="whatever", params=...)
# Remove when done
mcp --action remove --alias "their"
```
## 🛠️ Comprehensive Tool Ecosystem
### 📝 Interactive Development
- **notebook** - Multi-language notebooks with SoS (read/write/step/debug)
- **repl** - Interactive multi-language REPL with shared context
- **debugger** - Full debugging support with breakpoints and stepping
- **lsp** - Language Server Protocol with jupyter-lsp integration
### 🔍 Code Intelligence
- **search** - Unified multi-modal search (text/AST/vector/git/memory)
- **symbols** - AST-aware navigation with tree-sitter
- **find** - Fast file/directory discovery
- **grep** - Pattern matching with ripgrep
- **ast** - Code structure analysis
### 📁 File Operations
- **read/write/edit/multi_edit** - Intelligent file operations
- **tree** - Visual directory structures
- **watch** - File monitoring with notifications
- **diff** - Visual comparisons
### 🤖 AI & Automation
- **agent** - Multi-agent task delegation
- **consensus** - Multi-LLM agreement and validation
- **think** - Structured reasoning workspace
- **critic** - Automated code review and quality
- **batch** - Parallel tool execution
### 🖥️ System & Process
- **bash** - Command execution with session management
- **npx/uvx** - Package runners with auto-install
- **process** - Background process management
- **git** - Complete git integration with search
### 📊 Data & Analytics
- **vector** - Semantic search and indexing
- **sql** - Database operations and queries
- **graph** - Graph database operations
- **stats** - Performance and usage analytics
### 🎯 Project Management
- **todo** - Unified task management
- **rules** - Project preferences discovery
- **palette** - Tool configuration presets
- **mcp** - Dynamic MCP server orchestration
## 🚀 Quick Start
### Installation Methods
#### 1. Via pip/uv (Recommended)
```bash
# Installs globally
uvx hanzo-mcp
# Don't have uv? No problem - we'll install it for you!
curl -LsSf https://pypi.org/simple/hanzo-mcp | python3
```
#### 2. Desktop Extension (One-Click)
1. Download `hanzo-mcp.dxt` from [latest release](https://github.com/hanzoai/mcp/releases/latest)
2. Double-click to install in Claude Desktop
3. Restart Claude Desktop
#### 3. Manual Configuration
```json
// Add to Claude Desktop config
{
"mcpServers": {
"hanzo": {
"command": "uvx",
"args": ["hanzo-mcp"],
"env": {
"HANZO_ALLOWED_PATHS": "/Users/you/projects"
}
}
}
}
```
## 🔗 Ecosystem Integration
### Everything Works Together
```python
# Example: AI-assisted debugging workflow
# 1. Find the bug
search("null pointer exception")
# 2. Open in notebook for investigation
notebook(
action="create",
path="debug_session.ipynb",
import_code="src/auth.py:42-58"
)
# 3. Set breakpoints and debug
debugger(
notebook="debug_session.ipynb",
breakpoints=[45, 52]
)
# 4. Get AI analysis
critic("Analyze this exception and suggest fixes")
# 5. Apply the fix
edit("src/auth.py", old="user.name", new="user?.name")
# 6. Verify with tests
bash("pytest tests/test_auth.py -v")
```
### Tool Composition Power
- **Search → Notebook → Debug** - Investigate issues interactively
- **Agent → Critic → Test** - Automated quality workflows
- **LSP → AST → Edit** - Intelligent refactoring
- **Git → Search → Todo** - Project management workflows
## 🏆 Why Developers Love Hanzo
### Smart Defaults
- **Auto-installs** missing dependencies and language servers
- **Discovers** project rules and preferences automatically
- **Parallel** operations by default for speed
- **Intelligent** fallbacks when tools aren't available
### Quality First
- **Built-in critic** for automated code review
- **Test enforcement** in all workflows
- **Security scanning** in operations
- **Best practices** enforced by default
### Truly Extensible
- **Palette system** for instant context switching
- **MCP orchestration** to add any server dynamically
- **Plugin architecture** for custom tools
- **Everything is an API** for maximum flexibility
## 📊 Performance
- **65-70 tools** available instantly
- **Parallel execution** reduces wait times by 80%
- **Smart caching** for repeated operations
- **Minimal dependencies** for fast startup
## 🤝 Contributing
We welcome contributions! The codebase is designed for extensibility:
1. **Add a Tool**: Drop a file in `hanzo_mcp/tools/`
2. **Create a Palette**: Define tool collections
3. **Share Workflows**: Contribute your configurations
See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
## 📚 Documentation
- **[Installation Guide](https://mcp.hanzo.ai/install)** - All installation methods
- **[Tool Reference](https://mcp.hanzo.ai/tools)** - Complete tool documentation
- **[Palette System](https://mcp.hanzo.ai/palettes)** - Customize your workflow
- **[MCP Orchestration](https://mcp.hanzo.ai/orchestration)** - Extend with any MCP
- **[Best Practices](https://mcp.hanzo.ai/best-practices)** - Pro tips
## 🌟 Testimonials
> "The critic tool alone is worth it. My code quality improved overnight." - *Sr. Engineer at Fortune 500*
> "Finally, search that actually works. It knows what I mean, not just what I type." - *AI Researcher*
> "I threw away 15 different tools and just use Hanzo now. The palette system means I can switch from Python to DevOps to writing in seconds." - *Tech Lead*
## 📈 Project Status
- **Version**: 0.7.x (Production Ready)
- **Tools**: 70+ interconnected tools
- **Ecosystems**: Interactive notebooks, debugging, LSP, multi-agent
- **Languages**: Python, JavaScript, Go, R, Julia, Bash, and more via SoS
- **Community**: Active and growing
- **Updates**: Continuous improvements
## 🛡️ Security
- **Sandboxed execution** for all operations
- **Permission system** for file access
- **Audit trails** for compliance
- **No telemetry** without consent
## 🎯 The Zen of Hanzo
1. **One Tool, One Purpose** - Each tool masters one thing
2. **Quality Over Quantity** - Better to do it right
3. **Parallel When Possible** - Time is precious
4. **Smart Defaults** - It should just work
5. **Extensible Always** - Your workflow, your way
---
*Built with ❤️ by developers, for developers. Because life's too short for bad tools.*
**[Get Started Now →](https://mcp.hanzo.ai)**
Raw data
{
"_id": null,
"home_page": null,
"name": "hanzo-mcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": null,
"keywords": "mcp, claude, hanzo, code, agent",
"author": null,
"author_email": "Hanzo Industries Inc <dev@hanzo.ai>",
"download_url": "https://files.pythonhosted.org/packages/f6/e5/bf42310ab8203c6159dd01c69e66de606435c704e82226b8e6cb42b4fbdc/hanzo_mcp-0.7.0.tar.gz",
"platform": null,
"description": "# Hanzo AI - The Zen of Model Context Protocol\n\n[](https://mcp.hanzo.ai)\n[](https://pypi.org/project/hanzo-mcp/)\n[](https://github.com/hanzoai/mcp/releases/latest/download/hanzo-mcp.dxt)\n[](https://github.com/hanzoai/mcp/blob/main/LICENSE)\n[](https://discord.gg/hanzoai)\n\n## \ud83e\udd77 The Complete AI Development Ecosystem via MCP\n\n**One unified interface to orchestrate your entire development workflow.**\n\nHanzo AI is more than an MCP server\u2014it's a comprehensive ecosystem of interconnected development tools designed for the AI era. From interactive notebooks with multi-language support to advanced debugging, from intelligent code search to multi-agent workflows, everything works together seamlessly through the Model Context Protocol.\n\n```bash\n# Install and rule your development world\nuvx hanzo-mcp\n\n# Or use our one-click Desktop Extension\n# Download from releases and double-click to install\n```\n\n> **Note on Installation**: If uvx is not installed, Hanzo will automatically install it for you in your home directory. No manual setup required!\n\n## \ud83c\udf10 The Hanzo Ecosystem\n\n### Integrated Development Environment\n```mermaid\ngraph LR\n A[Hanzo MCP] --> B[Interactive Notebooks]\n A --> C[Code Intelligence]\n A --> D[Multi-Agent System]\n A --> E[Project Management]\n \n B --> B1[Multi-Language REPL]\n B --> B2[SoS Kernels]\n B --> B3[Live Debugging]\n \n C --> C1[LSP Integration]\n C --> C2[AST Analysis]\n C --> C3[Semantic Search]\n \n D --> D1[Agent Networks]\n D --> D2[Tool Orchestration]\n D --> D3[Consensus Systems]\n \n E --> E1[Git Integration]\n E --> E2[Task Management]\n E --> E3[Quality Control]\n```\n\n### \ud83c\udfaf Why Hanzo AI?\n\n**The Problem with Fragmented Tools**\n- Install 10 different tools that don't talk to each other\n- Context switching between interfaces kills productivity\n- No unified way to orchestrate complex workflows\n- Missing the power of tool composition\n\n**The Hanzo Solution**\n- **Unified Ecosystem**: 70+ tools that work together seamlessly\n- **Intelligent Orchestration**: Tools that understand context and collaborate\n- **Interactive Development**: From REPL to debugging in one interface\n- **Quality Built-in**: Automated review, testing, and best practices\n- **Extensible Platform**: Add any MCP server or custom tool\n\n## \ud83d\ude80 Core Capabilities\n\n### \ud83d\udcd3 Interactive Development Environment\n\n#### Multi-Language Notebooks with SoS\n```python\n# Work with multiple languages in one notebook\nnotebook(\n action=\"create\",\n path=\"analysis.ipynb\",\n kernels=[\"python3\", \"R\", \"javascript\", \"bash\"]\n)\n\n# Write and execute code interactively\nnotebook(\n action=\"write\",\n cell_type=\"code\",\n content=\"\"\"\n # Python cell\n data = load_dataset()\n processed = clean_data(data)\n \"\"\",\n kernel=\"python3\"\n)\n\n# Step through execution line by line\nnotebook(\n action=\"step\",\n cell_id=\"cell_123\",\n lines=[1, 2, 3] # Execute specific lines\n)\n\n# Read results and outputs\nresult = notebook(\n action=\"read\",\n cell_id=\"cell_123\",\n include_outputs=True\n)\n\n# Launch debugger for interactive debugging\ndebugger(\n notebook=\"analysis.ipynb\",\n cell_id=\"cell_123\",\n breakpoint=15\n)\n```\n\n#### Interactive REPL Sessions\n```python\n# Start multi-language REPL\nrepl(\n languages=[\"python\", \"javascript\", \"go\"],\n project_dir=\"/path/to/project\",\n share_context=True # Share variables between languages\n)\n\n# Execute code with full project context\nrepl.execute(\"\"\"\nimport project_module\nresult = project_module.process()\n\"\"\", language=\"python\")\n```\n\n### \ud83e\udde0 Advanced AI Tools\n\n#### Multi-Agent Workflows\n```python\n# Delegate complex tasks to specialized agents\nagent(\n prompts=[\"Find all API endpoints\", \"Document each endpoint\", \"Generate OpenAPI spec\"],\n parallel=True # Run agents concurrently\n)\n\n# Get consensus from multiple LLMs\nconsensus(\n prompt=\"Review this architecture decision\",\n providers=[\"openai\", \"anthropic\", \"google\"],\n threshold=0.8 # Require 80% agreement\n)\n```\n\n#### Built-in Code Critic\n```python\n# Force high-quality standards with the critic tool\ncritic(\n analysis=\"Review authentication implementation for security issues\"\n)\n# The critic will:\n# - Find potential bugs and edge cases\n# - Ensure proper error handling\n# - Verify test coverage\n# - Check security implications\n# - Suggest improvements\n# - Enforce best practices\n```\n\n### \ud83d\udcdd Project Intelligence\n\n#### Automatic Rules Discovery\n```python\n# Reads your project preferences automatically\nrules() # Finds .cursorrules, .claude/code.md, etc.\n# Understands your:\n# - Coding standards\n# - Project conventions \n# - AI assistant preferences\n# - Team guidelines\n```\n\n#### Unified Todo Management\n```python\n# Single tool for all task management\ntodo(\"Add authentication to API\")\ntodo --action update --id abc123 --status in_progress\ntodo --action list --filter pending\n```\n\n### \ud83d\udd0d Intelligent Code Intelligence\n\n#### Unified Search Engine\n```python\n# One search to rule them all - automatically runs in parallel:\n# - Text search with ripgrep\n# - AST analysis for code structure\n# - Vector search for semantic meaning\n# - Git history search (integrated into git tool)\n# - Symbol search with LSP\n# - Memory search for past discussions\nsearch(\"authentication flow\")\n```\n\n#### Language Server Protocol (LSP) Integration\n```python\n# Full LSP support with jupyter-lsp integration\nlsp(\n action=\"initialize\",\n language=\"python\",\n project_dir=\"/path/to/project\"\n)\n\n# Go to definition, find references, rename symbols\nlsp.goto_definition(\"UserService.authenticate\")\nlsp.find_references(\"API_KEY\")\nlsp.rename_symbol(\"oldFunction\", \"newFunction\")\n\n# Get diagnostics and hover information\ndiagnostics = lsp.get_diagnostics(\"main.py\")\ninfo = lsp.hover(\"mysterious_function\", line=42, col=15)\n```\n\n#### Git Integration (with built-in search)\n```python\n# All git operations in one tool\ngit(\"status\")\ngit(\"diff\", \"--cached\")\ngit(\"log\", \"--oneline\", \"-10\")\n\n# Git search is now part of the git tool\ngit(\"search\", pattern=\"TODO\", history=True)\ngit(\"blame\", file=\"src/auth.py\", line=42)\ngit(\"show\", commit=\"abc123:src/main.py\")\n```\n\n### \ud83c\udfa8 Palette System - Opinions Are Just Configurations\n```python\n# Don't like our defaults? Switch instantly\npalette --action activate python # Python development focused\npalette --action activate javascript # Node.js/React optimized\npalette --action activate devops # Infrastructure tools\npalette --action activate academic # Research & documentation\n\n# Create your own workflow\npalette_create(\n name=\"my-workflow\",\n tools=[\"read\", \"write\", \"edit\", \"search\", \"critic\", \"agent\"],\n env_vars={\"EDITOR\": \"nvim\", \"SEARCH\": \"ripgrep\"}\n)\n```\n\n### \ud83d\udd0c MCP Server Orchestration\n```python\n# Add any MCP server dynamically\nmcp --action add --url \"github.com/someone/their-mcp\" --alias \"their\"\n\n# Use their tools seamlessly\ntheir_tool(action=\"whatever\", params=...)\n\n# Remove when done\nmcp --action remove --alias \"their\"\n```\n\n## \ud83d\udee0\ufe0f Comprehensive Tool Ecosystem\n\n### \ud83d\udcdd Interactive Development\n- **notebook** - Multi-language notebooks with SoS (read/write/step/debug)\n- **repl** - Interactive multi-language REPL with shared context\n- **debugger** - Full debugging support with breakpoints and stepping\n- **lsp** - Language Server Protocol with jupyter-lsp integration\n\n### \ud83d\udd0d Code Intelligence\n- **search** - Unified multi-modal search (text/AST/vector/git/memory)\n- **symbols** - AST-aware navigation with tree-sitter\n- **find** - Fast file/directory discovery\n- **grep** - Pattern matching with ripgrep\n- **ast** - Code structure analysis\n\n### \ud83d\udcc1 File Operations\n- **read/write/edit/multi_edit** - Intelligent file operations\n- **tree** - Visual directory structures\n- **watch** - File monitoring with notifications\n- **diff** - Visual comparisons\n\n### \ud83e\udd16 AI & Automation\n- **agent** - Multi-agent task delegation\n- **consensus** - Multi-LLM agreement and validation\n- **think** - Structured reasoning workspace\n- **critic** - Automated code review and quality\n- **batch** - Parallel tool execution\n\n### \ud83d\udda5\ufe0f System & Process\n- **bash** - Command execution with session management\n- **npx/uvx** - Package runners with auto-install\n- **process** - Background process management\n- **git** - Complete git integration with search\n\n### \ud83d\udcca Data & Analytics\n- **vector** - Semantic search and indexing\n- **sql** - Database operations and queries\n- **graph** - Graph database operations\n- **stats** - Performance and usage analytics\n\n### \ud83c\udfaf Project Management\n- **todo** - Unified task management\n- **rules** - Project preferences discovery\n- **palette** - Tool configuration presets\n- **mcp** - Dynamic MCP server orchestration\n\n## \ud83d\ude80 Quick Start\n\n### Installation Methods\n\n#### 1. Via pip/uv (Recommended)\n```bash\n# Installs globally\nuvx hanzo-mcp\n\n# Don't have uv? No problem - we'll install it for you!\ncurl -LsSf https://pypi.org/simple/hanzo-mcp | python3\n```\n\n#### 2. Desktop Extension (One-Click)\n1. Download `hanzo-mcp.dxt` from [latest release](https://github.com/hanzoai/mcp/releases/latest)\n2. Double-click to install in Claude Desktop\n3. Restart Claude Desktop\n\n#### 3. Manual Configuration\n```json\n// Add to Claude Desktop config\n{\n \"mcpServers\": {\n \"hanzo\": {\n \"command\": \"uvx\",\n \"args\": [\"hanzo-mcp\"],\n \"env\": {\n \"HANZO_ALLOWED_PATHS\": \"/Users/you/projects\"\n }\n }\n }\n}\n```\n\n## \ud83d\udd17 Ecosystem Integration\n\n### Everything Works Together\n```python\n# Example: AI-assisted debugging workflow\n# 1. Find the bug\nsearch(\"null pointer exception\")\n\n# 2. Open in notebook for investigation\nnotebook(\n action=\"create\",\n path=\"debug_session.ipynb\",\n import_code=\"src/auth.py:42-58\"\n)\n\n# 3. Set breakpoints and debug\ndebugger(\n notebook=\"debug_session.ipynb\",\n breakpoints=[45, 52]\n)\n\n# 4. Get AI analysis\ncritic(\"Analyze this exception and suggest fixes\")\n\n# 5. Apply the fix\nedit(\"src/auth.py\", old=\"user.name\", new=\"user?.name\")\n\n# 6. Verify with tests\nbash(\"pytest tests/test_auth.py -v\")\n```\n\n### Tool Composition Power\n- **Search \u2192 Notebook \u2192 Debug** - Investigate issues interactively\n- **Agent \u2192 Critic \u2192 Test** - Automated quality workflows\n- **LSP \u2192 AST \u2192 Edit** - Intelligent refactoring\n- **Git \u2192 Search \u2192 Todo** - Project management workflows\n\n## \ud83c\udfc6 Why Developers Love Hanzo\n\n### Smart Defaults\n- **Auto-installs** missing dependencies and language servers\n- **Discovers** project rules and preferences automatically\n- **Parallel** operations by default for speed\n- **Intelligent** fallbacks when tools aren't available\n\n### Quality First\n- **Built-in critic** for automated code review\n- **Test enforcement** in all workflows\n- **Security scanning** in operations\n- **Best practices** enforced by default\n\n### Truly Extensible\n- **Palette system** for instant context switching\n- **MCP orchestration** to add any server dynamically\n- **Plugin architecture** for custom tools\n- **Everything is an API** for maximum flexibility\n\n## \ud83d\udcca Performance\n\n- **65-70 tools** available instantly\n- **Parallel execution** reduces wait times by 80%\n- **Smart caching** for repeated operations\n- **Minimal dependencies** for fast startup\n\n## \ud83e\udd1d Contributing\n\nWe welcome contributions! The codebase is designed for extensibility:\n\n1. **Add a Tool**: Drop a file in `hanzo_mcp/tools/`\n2. **Create a Palette**: Define tool collections\n3. **Share Workflows**: Contribute your configurations\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n## \ud83d\udcda Documentation\n\n- **[Installation Guide](https://mcp.hanzo.ai/install)** - All installation methods\n- **[Tool Reference](https://mcp.hanzo.ai/tools)** - Complete tool documentation\n- **[Palette System](https://mcp.hanzo.ai/palettes)** - Customize your workflow\n- **[MCP Orchestration](https://mcp.hanzo.ai/orchestration)** - Extend with any MCP\n- **[Best Practices](https://mcp.hanzo.ai/best-practices)** - Pro tips\n\n## \ud83c\udf1f Testimonials\n\n> \"The critic tool alone is worth it. My code quality improved overnight.\" - *Sr. Engineer at Fortune 500*\n\n> \"Finally, search that actually works. It knows what I mean, not just what I type.\" - *AI Researcher*\n\n> \"I threw away 15 different tools and just use Hanzo now. The palette system means I can switch from Python to DevOps to writing in seconds.\" - *Tech Lead*\n\n## \ud83d\udcc8 Project Status\n\n- **Version**: 0.7.x (Production Ready)\n- **Tools**: 70+ interconnected tools\n- **Ecosystems**: Interactive notebooks, debugging, LSP, multi-agent\n- **Languages**: Python, JavaScript, Go, R, Julia, Bash, and more via SoS\n- **Community**: Active and growing\n- **Updates**: Continuous improvements\n\n## \ud83d\udee1\ufe0f Security\n\n- **Sandboxed execution** for all operations\n- **Permission system** for file access\n- **Audit trails** for compliance\n- **No telemetry** without consent\n\n## \ud83c\udfaf The Zen of Hanzo\n\n1. **One Tool, One Purpose** - Each tool masters one thing\n2. **Quality Over Quantity** - Better to do it right\n3. **Parallel When Possible** - Time is precious\n4. **Smart Defaults** - It should just work\n5. **Extensible Always** - Your workflow, your way\n\n---\n\n*Built with \u2764\ufe0f by developers, for developers. Because life's too short for bad tools.*\n\n**[Get Started Now \u2192](https://mcp.hanzo.ai)**\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "The Zen of Hanzo MCP: One server to rule them all. The ultimate MCP that orchestrates all others.",
"version": "0.7.0",
"project_urls": {
"Bug Tracker": "https://github.com/hanzoai/mcp/issues",
"Documentation": "https://mcp.hanzo.ai",
"Homepage": "https://github.com/hanzoai/mcp"
},
"split_keywords": [
"mcp",
" claude",
" hanzo",
" code",
" agent"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "f07ac6fba696aa581ac8fa89d46f37337ce5777abc306d7310ab2f09ff4bd179",
"md5": "ec6eb85927301b393c145d76dd587ad5",
"sha256": "83f17436cfe6e2494085880caa864632f39a2410f1d4eef4375112e9647e80d2"
},
"downloads": -1,
"filename": "hanzo_mcp-0.7.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ec6eb85927301b393c145d76dd587ad5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 492868,
"upload_time": "2025-07-26T00:11:45",
"upload_time_iso_8601": "2025-07-26T00:11:45.759794Z",
"url": "https://files.pythonhosted.org/packages/f0/7a/c6fba696aa581ac8fa89d46f37337ce5777abc306d7310ab2f09ff4bd179/hanzo_mcp-0.7.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "f6e5bf42310ab8203c6159dd01c69e66de606435c704e82226b8e6cb42b4fbdc",
"md5": "bec2a7a2e1e66471941bf6219da24f9f",
"sha256": "b5ce7875d9cc1de1b6fb668f8e9835c6af04103a57912a5bcb97136eb976657f"
},
"downloads": -1,
"filename": "hanzo_mcp-0.7.0.tar.gz",
"has_sig": false,
"md5_digest": "bec2a7a2e1e66471941bf6219da24f9f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 438673,
"upload_time": "2025-07-26T00:11:47",
"upload_time_iso_8601": "2025-07-26T00:11:47.060903Z",
"url": "https://files.pythonhosted.org/packages/f6/e5/bf42310ab8203c6159dd01c69e66de606435c704e82226b8e6cb42b4fbdc/hanzo_mcp-0.7.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-26 00:11:47",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "hanzoai",
"github_project": "mcp",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "hanzo-mcp"
}
