hanzo-mcp 0.5.2__tar.gz → 0.6.1__tar.gz

hanzo_mcp-0.6.1/PKG-INFO

@@ -0,0 +1,336 @@
+Metadata-Version: 2.4
+Name: hanzo-mcp
+Version: 0.6.1
+Summary: The Zen of Hanzo MCP: One server to rule them all. The ultimate MCP that orchestrates all others.
+Author-email: Hanzo Industries Inc <dev@hanzo.ai>
+License: MIT
+Project-URL: Homepage, https://github.com/hanzoai/mcp
+Project-URL: Bug Tracker, https://github.com/hanzoai/mcp/issues
+Project-URL: Documentation, https://mcp.hanzo.ai
+Keywords: mcp,claude,hanzo,code,agent
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mcp>=1.6.0
+Requires-Dist: fastmcp>=2.8.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: uvicorn>=0.23.1
+Requires-Dist: openai>=1.50.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: litellm>=1.40.14
+Requires-Dist: grep-ast>=0.8.1
+Requires-Dist: bashlex>=0.18
+Requires-Dist: libtmux>=0.39.0
+Requires-Dist: nbformat>=5.10.4
+Requires-Dist: psutil>=6.1.0
+Requires-Dist: pydantic>=2.10.0
+Requires-Dist: typing-extensions>=4.12.2
+Requires-Dist: watchdog>=3.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: black>=23.3.0; extra == "dev"
+Requires-Dist: sphinx>=8.0.0; extra == "dev"
+Requires-Dist: sphinx-rtd-theme>=3.0.0; extra == "dev"
+Requires-Dist: myst-parser>=4.0.0; extra == "dev"
+Requires-Dist: sphinx-copybutton>=0.5.0; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: sphinx>=8.0.0; extra == "docs"
+Requires-Dist: sphinx-rtd-theme>=3.0.0; extra == "docs"
+Requires-Dist: myst-parser>=4.0.0; extra == "docs"
+Requires-Dist: sphinx-copybutton>=0.5.0; extra == "docs"
+Provides-Extra: test
+Requires-Dist: pytest>=7.0.0; extra == "test"
+Requires-Dist: pytest-cov>=4.1.0; extra == "test"
+Requires-Dist: pytest-mock>=3.10.0; extra == "test"
+Requires-Dist: pytest-asyncio>=0.25.3; extra == "test"
+Requires-Dist: twisted; extra == "test"
+Provides-Extra: performance
+Requires-Dist: ujson>=5.7.0; extra == "performance"
+Requires-Dist: orjson>=3.9.0; extra == "performance"
+Provides-Extra: publish
+Requires-Dist: twine>=4.0.2; extra == "publish"
+Requires-Dist: build>=1.0.3; extra == "publish"
+Dynamic: license-file
+
+# Hanzo MCP - The Zen of Model Context Protocol
+
+[![Documentation](https://img.shields.io/badge/docs-mcp.hanzo.ai-blue?style=for-the-badge)](https://mcp.hanzo.ai)
+[![PyPI](https://img.shields.io/pypi/v/hanzo-mcp?style=for-the-badge)](https://pypi.org/project/hanzo-mcp/)
+[![License](https://img.shields.io/github/license/hanzoai/mcp?style=for-the-badge)](https://github.com/hanzoai/mcp/blob/main/LICENSE)
+[![Join our Discord](https://img.shields.io/discord/YOUR_DISCORD_ID?style=for-the-badge&logo=discord)](https://discord.gg/hanzoai)
+
+## 🥷 One MCP to Rule Them All
+
+**Start here. Add other MCPs later. Control everything through one opinionated interface.**
+
+Hanzo MCP isn't just another Model Context Protocol server—it's **THE** MCP server. While others give you fragments, we give you the complete toolkit. One server that orchestrates all others, with the power to add, remove, and control any MCP server dynamically.
+
+```bash
+# Install and rule your development world
+uvx hanzo-mcp
+```
+
+## 🎯 Why Hanzo MCP?
+
+### The Problem with Other MCPs
+- **Fragmented Experience**: Install 10 different MCPs for 10 different tasks
+- **Inconsistent Interfaces**: Each MCP has its own conventions and quirks  
+- **Limited Scope**: Most MCPs do one thing, leaving you to juggle multiple servers
+- **No Orchestration**: No way to coordinate between different MCP servers
+
+### The Hanzo Way
+- **One Installation**: 65+ professional tools out of the box
+- **Unified Philosophy**: Consistent, opinionated interface following Unix principles
+- **MCP Orchestration**: Install and control other MCP servers through Hanzo
+- **Swappable Opinions**: Don't like our way? Load a different palette and change everything
+
+## 🚀 Features That Set Us Apart
+
+### 🎨 Palette System - Opinions Are Just Configurations
+```python
+# Don't like our shell tools? Swap the palette
+palette_load(palette="minimal")  # Just the essentials
+palette_load(palette="pentesting")  # Security focused tools  
+palette_load(palette="data-science")  # Jupyter, pandas, numpy focused
+palette_load(palette="your-custom")  # Your tools, your way
+```
+
+### 🔌 MCP Server Orchestration
+```python
+# Add any MCP server dynamically
+mcp_add(url="github.com/someone/their-mcp", alias="their")
+
+# Use their tools through our unified interface
+their_tool(action="whatever", params=...)
+
+# Remove when done
+mcp_remove(alias="their")
+```
+
+### 🛠️ 65+ Battle-Tested Tools
+
+#### Intelligent Multi-Modal Search
+- **search**: Combines grep, AST analysis, vector embeddings, and git history
+- **symbols**: Find any code symbol across languages instantly
+- **git_search**: Search through git history, branches, and commits
+
+#### Advanced Development
+- **agent**: Delegate complex tasks to specialized AI agents
+- **llm**: Query multiple LLM providers with consensus
+- **jupyter**: Full Jupyter notebook support
+- **neovim**: Integrated Neovim for power users
+
+#### File Operations That Just Work
+- **edit/multi_edit**: Intelligent pattern-based editing
+- **read/write**: Automatic encoding detection
+- **tree**: Visual directory structures
+- **watch**: Monitor file changes in real-time
+
+#### Process & System Control  
+- **run_command**: Secure command execution with timeout
+- **processes**: Monitor and manage system processes
+- **npx/uvx**: Package runners with background support
+
+#### And So Much More
+- Database tools (SQL, Graph)
+- Vector search and indexing
+- Todo management
+- Configuration management
+- MCP server management
+- Statistical analysis
+- Batch operations
+
+## 🎯 The Zen of Hanzo
+
+1. **One Tool, One Purpose** - Each tool does one thing exceptionally well
+2. **Actions Over Tools** - Complex tools support multiple actions, not multiple interfaces
+3. **Parallel by Default** - Run multiple operations concurrently
+4. **Smart Fallbacks** - Automatically choose the best available backend
+5. **Secure by Design** - Fine-grained permissions and audit trails
+6. **Opinionated but Flexible** - Strong defaults with palette customization
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+# Install globally with uvx (recommended)
+uvx hanzo-mcp
+
+# Or install with pip
+pip install hanzo-mcp
+
+# Or install from source for development
+git clone https://github.com/hanzoai/mcp
+cd mcp
+make install
+```
+
+### Add to Claude Desktop
+
+```bash
+# Automatic installation
+make install-desktop
+
+# Or manual configuration
+cat >> ~/Library/Application\ Support/Claude/claude_desktop_config.json << 'EOF'
+{
+  "mcpServers": {
+    "hanzo": {
+      "command": "uvx",
+      "args": ["hanzo-mcp"]
+    }
+  }
+}
+EOF
+```
+
+### Your First Session
+
+1. Open Claude Desktop
+2. Start with `search` to explore any codebase
+3. Use `tree` to understand structure  
+4. Edit files with `edit` or `multi_edit`
+5. Run commands with `run_command`
+6. Add other MCP servers with `mcp_add`
+
+## 🎨 Palette System
+
+Palettes let you completely transform Hanzo MCP's behavior:
+
+```python
+# List available palettes
+palette_list()
+
+# Load a different personality
+palette_load(palette="minimal")  # Just core tools
+palette_load(palette="academic")  # Research and writing focused
+palette_load(palette="devops")   # Infrastructure and deployment
+
+# Create your own
+palette_create(
+    name="my-workflow",
+    tools=["read", "write", "edit", "search", "my-custom-tool"],
+    config={"editor": "vim", "search_backend": "ripgrep"}
+)
+```
+
+## 🔌 MCP Orchestration
+
+Hanzo MCP can manage other MCP servers:
+
+```python
+# Add any MCP server
+mcp_add(url="github.com/modelcontextprotocol/servers/tree/main/postgres")
+
+# List installed servers
+mcp_stats()
+
+# Use tools from other servers seamlessly
+postgres_query(query="SELECT * FROM users")
+
+# Remove when done
+mcp_remove(alias="postgres")
+```
+
+## 📊 Advanced Features
+
+### Intelligent Search
+```python
+# Multi-modal search across your codebase
+results = search(
+    query="authentication",
+    include_git=True,      # Search git history
+    include_vector=True,   # Semantic search
+    include_ast=True,      # AST symbol search
+    parallel=True          # Search all modes concurrently
+)
+```
+
+### Agent Orchestration  
+```python
+# Delegate complex tasks to specialized agents
+agent(
+    task="Refactor this codebase to use async/await",
+    files=["src/**/*.py"],
+    instructions="Maintain backwards compatibility"
+)
+```
+
+### Consensus LLM Queries
+```python
+# Query multiple LLMs and get consensus
+llm(
+    action="consensus",
+    prompt="Is this code secure?",
+    providers=["openai", "anthropic", "google"],
+    threshold=0.8
+)
+```
+
+## 🏗️ Architecture
+
+Built on modern Python with:
+- **FastMCP**: High-performance MCP framework
+- **UV**: Lightning-fast Python package management
+- **Parallel Execution**: Concurrent operations by default
+- **Smart Backends**: Automatic selection of best available tools
+- **Type Safety**: Full type hints and validation
+
+## 🤝 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 and configurations
+3. **Improve Existing Tools**: Each tool is independently testable
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## 📚 Documentation
+
+- **[Quick Start Guide](https://mcp.hanzo.ai/quickstart)** - Get running in 5 minutes
+- **[Tool Reference](https://mcp.hanzo.ai/tools)** - Detailed documentation for all 65+ tools  
+- **[Palette System](https://mcp.hanzo.ai/palettes)** - Customize your experience
+- **[MCP Orchestration](https://mcp.hanzo.ai/orchestration)** - Control other MCP servers
+- **[Best Practices](https://mcp.hanzo.ai/best-practices)** - Tips from power users
+
+## 🌟 Why Developers Choose Hanzo MCP
+
+> "I replaced 12 different MCP servers with just Hanzo. The palette system means I can switch contexts instantly—from web dev to data science to DevOps." - *Power User*
+
+> "The agent orchestration is incredible. I can delegate entire refactoring tasks and it just works." - *Sr. Engineer*
+
+> "Finally, an MCP that thinks like a developer. Smart defaults, great errors, and everything is parallel." - *Tech Lead*
+
+## 📈 Stats
+
+- **65+** Professional Tools
+- **10x** Faster than installing multiple MCPs
+- **1** Unified interface to rule them all
+- **∞** Possibilities with the palette system
+
+## 📄 License
+
+MIT - Use it, extend it, make it yours.
+
+## 🔗 Links
+
+- [GitHub](https://github.com/hanzoai/mcp)
+- [Documentation](https://mcp.hanzo.ai)
+- [PyPI](https://pypi.org/project/hanzo-mcp/)
+- [Discord Community](https://discord.gg/hanzoai)
+- [Report Issues](https://github.com/hanzoai/mcp/issues)
+
+---
+
+<p align="center">
+  <b>The Zen of Hanzo MCP</b><br>
+  <i>One server. All tools. Your way.</i><br><br>
+  <code>uvx hanzo-mcp</code>
+</p>

hanzo_mcp-0.6.1/README.md

@@ -0,0 +1,277 @@
+# Hanzo MCP - The Zen of Model Context Protocol
+
+[![Documentation](https://img.shields.io/badge/docs-mcp.hanzo.ai-blue?style=for-the-badge)](https://mcp.hanzo.ai)
+[![PyPI](https://img.shields.io/pypi/v/hanzo-mcp?style=for-the-badge)](https://pypi.org/project/hanzo-mcp/)
+[![License](https://img.shields.io/github/license/hanzoai/mcp?style=for-the-badge)](https://github.com/hanzoai/mcp/blob/main/LICENSE)
+[![Join our Discord](https://img.shields.io/discord/YOUR_DISCORD_ID?style=for-the-badge&logo=discord)](https://discord.gg/hanzoai)
+
+## 🥷 One MCP to Rule Them All
+
+**Start here. Add other MCPs later. Control everything through one opinionated interface.**
+
+Hanzo MCP isn't just another Model Context Protocol server—it's **THE** MCP server. While others give you fragments, we give you the complete toolkit. One server that orchestrates all others, with the power to add, remove, and control any MCP server dynamically.
+
+```bash
+# Install and rule your development world
+uvx hanzo-mcp
+```
+
+## 🎯 Why Hanzo MCP?
+
+### The Problem with Other MCPs
+- **Fragmented Experience**: Install 10 different MCPs for 10 different tasks
+- **Inconsistent Interfaces**: Each MCP has its own conventions and quirks  
+- **Limited Scope**: Most MCPs do one thing, leaving you to juggle multiple servers
+- **No Orchestration**: No way to coordinate between different MCP servers
+
+### The Hanzo Way
+- **One Installation**: 65+ professional tools out of the box
+- **Unified Philosophy**: Consistent, opinionated interface following Unix principles
+- **MCP Orchestration**: Install and control other MCP servers through Hanzo
+- **Swappable Opinions**: Don't like our way? Load a different palette and change everything
+
+## 🚀 Features That Set Us Apart
+
+### 🎨 Palette System - Opinions Are Just Configurations
+```python
+# Don't like our shell tools? Swap the palette
+palette_load(palette="minimal")  # Just the essentials
+palette_load(palette="pentesting")  # Security focused tools  
+palette_load(palette="data-science")  # Jupyter, pandas, numpy focused
+palette_load(palette="your-custom")  # Your tools, your way
+```
+
+### 🔌 MCP Server Orchestration
+```python
+# Add any MCP server dynamically
+mcp_add(url="github.com/someone/their-mcp", alias="their")
+
+# Use their tools through our unified interface
+their_tool(action="whatever", params=...)
+
+# Remove when done
+mcp_remove(alias="their")
+```
+
+### 🛠️ 65+ Battle-Tested Tools
+
+#### Intelligent Multi-Modal Search
+- **search**: Combines grep, AST analysis, vector embeddings, and git history
+- **symbols**: Find any code symbol across languages instantly
+- **git_search**: Search through git history, branches, and commits
+
+#### Advanced Development
+- **agent**: Delegate complex tasks to specialized AI agents
+- **llm**: Query multiple LLM providers with consensus
+- **jupyter**: Full Jupyter notebook support
+- **neovim**: Integrated Neovim for power users
+
+#### File Operations That Just Work
+- **edit/multi_edit**: Intelligent pattern-based editing
+- **read/write**: Automatic encoding detection
+- **tree**: Visual directory structures
+- **watch**: Monitor file changes in real-time
+
+#### Process & System Control  
+- **run_command**: Secure command execution with timeout
+- **processes**: Monitor and manage system processes
+- **npx/uvx**: Package runners with background support
+
+#### And So Much More
+- Database tools (SQL, Graph)
+- Vector search and indexing
+- Todo management
+- Configuration management
+- MCP server management
+- Statistical analysis
+- Batch operations
+
+## 🎯 The Zen of Hanzo
+
+1. **One Tool, One Purpose** - Each tool does one thing exceptionally well
+2. **Actions Over Tools** - Complex tools support multiple actions, not multiple interfaces
+3. **Parallel by Default** - Run multiple operations concurrently
+4. **Smart Fallbacks** - Automatically choose the best available backend
+5. **Secure by Design** - Fine-grained permissions and audit trails
+6. **Opinionated but Flexible** - Strong defaults with palette customization
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+# Install globally with uvx (recommended)
+uvx hanzo-mcp
+
+# Or install with pip
+pip install hanzo-mcp
+
+# Or install from source for development
+git clone https://github.com/hanzoai/mcp
+cd mcp
+make install
+```
+
+### Add to Claude Desktop
+
+```bash
+# Automatic installation
+make install-desktop
+
+# Or manual configuration
+cat >> ~/Library/Application\ Support/Claude/claude_desktop_config.json << 'EOF'
+{
+  "mcpServers": {
+    "hanzo": {
+      "command": "uvx",
+      "args": ["hanzo-mcp"]
+    }
+  }
+}
+EOF
+```
+
+### Your First Session
+
+1. Open Claude Desktop
+2. Start with `search` to explore any codebase
+3. Use `tree` to understand structure  
+4. Edit files with `edit` or `multi_edit`
+5. Run commands with `run_command`
+6. Add other MCP servers with `mcp_add`
+
+## 🎨 Palette System
+
+Palettes let you completely transform Hanzo MCP's behavior:
+
+```python
+# List available palettes
+palette_list()
+
+# Load a different personality
+palette_load(palette="minimal")  # Just core tools
+palette_load(palette="academic")  # Research and writing focused
+palette_load(palette="devops")   # Infrastructure and deployment
+
+# Create your own
+palette_create(
+    name="my-workflow",
+    tools=["read", "write", "edit", "search", "my-custom-tool"],
+    config={"editor": "vim", "search_backend": "ripgrep"}
+)
+```
+
+## 🔌 MCP Orchestration
+
+Hanzo MCP can manage other MCP servers:
+
+```python
+# Add any MCP server
+mcp_add(url="github.com/modelcontextprotocol/servers/tree/main/postgres")
+
+# List installed servers
+mcp_stats()
+
+# Use tools from other servers seamlessly
+postgres_query(query="SELECT * FROM users")
+
+# Remove when done
+mcp_remove(alias="postgres")
+```
+
+## 📊 Advanced Features
+
+### Intelligent Search
+```python
+# Multi-modal search across your codebase
+results = search(
+    query="authentication",
+    include_git=True,      # Search git history
+    include_vector=True,   # Semantic search
+    include_ast=True,      # AST symbol search
+    parallel=True          # Search all modes concurrently
+)
+```
+
+### Agent Orchestration  
+```python
+# Delegate complex tasks to specialized agents
+agent(
+    task="Refactor this codebase to use async/await",
+    files=["src/**/*.py"],
+    instructions="Maintain backwards compatibility"
+)
+```
+
+### Consensus LLM Queries
+```python
+# Query multiple LLMs and get consensus
+llm(
+    action="consensus",
+    prompt="Is this code secure?",
+    providers=["openai", "anthropic", "google"],
+    threshold=0.8
+)
+```
+
+## 🏗️ Architecture
+
+Built on modern Python with:
+- **FastMCP**: High-performance MCP framework
+- **UV**: Lightning-fast Python package management
+- **Parallel Execution**: Concurrent operations by default
+- **Smart Backends**: Automatic selection of best available tools
+- **Type Safety**: Full type hints and validation
+
+## 🤝 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 and configurations
+3. **Improve Existing Tools**: Each tool is independently testable
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## 📚 Documentation
+
+- **[Quick Start Guide](https://mcp.hanzo.ai/quickstart)** - Get running in 5 minutes
+- **[Tool Reference](https://mcp.hanzo.ai/tools)** - Detailed documentation for all 65+ tools  
+- **[Palette System](https://mcp.hanzo.ai/palettes)** - Customize your experience
+- **[MCP Orchestration](https://mcp.hanzo.ai/orchestration)** - Control other MCP servers
+- **[Best Practices](https://mcp.hanzo.ai/best-practices)** - Tips from power users
+
+## 🌟 Why Developers Choose Hanzo MCP
+
+> "I replaced 12 different MCP servers with just Hanzo. The palette system means I can switch contexts instantly—from web dev to data science to DevOps." - *Power User*
+
+> "The agent orchestration is incredible. I can delegate entire refactoring tasks and it just works." - *Sr. Engineer*
+
+> "Finally, an MCP that thinks like a developer. Smart defaults, great errors, and everything is parallel." - *Tech Lead*
+
+## 📈 Stats
+
+- **65+** Professional Tools
+- **10x** Faster than installing multiple MCPs
+- **1** Unified interface to rule them all
+- **∞** Possibilities with the palette system
+
+## 📄 License
+
+MIT - Use it, extend it, make it yours.
+
+## 🔗 Links
+
+- [GitHub](https://github.com/hanzoai/mcp)
+- [Documentation](https://mcp.hanzo.ai)
+- [PyPI](https://pypi.org/project/hanzo-mcp/)
+- [Discord Community](https://discord.gg/hanzoai)
+- [Report Issues](https://github.com/hanzoai/mcp/issues)
+
+---
+
+<p align="center">
+  <b>The Zen of Hanzo MCP</b><br>
+  <i>One server. All tools. Your way.</i><br><br>
+  <code>uvx hanzo-mcp</code>
+</p>

{hanzo_mcp-0.5.2 → hanzo_mcp-0.6.1}/hanzo_mcp/__init__.py

@@ -1,3 +1,3 @@
 """Hanzo MCP - Implementation of Hanzo capabilities using MCP."""
 
-__version__ = "0.5.2"
+__version__ = "0.6.0"

{hanzo_mcp-0.5.2 → hanzo_mcp-0.6.1}/hanzo_mcp/cli.py

@@ -145,6 +145,12 @@ def main() -> None:
         help="Single project directory (alias for --project)",
     )
 
+    _ = parser.add_argument(
+        "--dev",
+        action="store_true",
+        help="Run in development mode with hot reload",
+    )
+    
     _ = parser.add_argument(
         "--install",
         action="store_true",
@@ -156,6 +162,7 @@ def main() -> None:
     # Cast args attributes to appropriate types to avoid 'Any' warnings
     name: str = cast(str, args.name)
     install: bool = cast(bool, args.install)
+    dev: bool = cast(bool, args.dev)
     transport: str = cast(str, args.transport)
     agent_model: str | None = cast(str | None, args.agent_model)
     agent_max_tokens: int | None = cast(int | None, args.agent_max_tokens)
@@ -200,6 +207,31 @@ def main() -> None:
     if not allowed_paths:
         allowed_paths = [os.getcwd()]
 
+    # Run in dev mode if requested
+    if dev:
+        from hanzo_mcp.dev_server import DevServer
+        
+        dev_server = DevServer(
+            name=name,
+            allowed_paths=allowed_paths,
+            project_paths=project_paths,
+            project_dir=project_dir,
+            agent_model=agent_model,
+            agent_max_tokens=agent_max_tokens,
+            agent_api_key=agent_api_key,
+            agent_base_url=agent_base_url,
+            agent_max_iterations=agent_max_iterations,
+            agent_max_tool_uses=agent_max_tool_uses,
+            enable_agent_tool=enable_agent_tool,
+            command_timeout=command_timeout,
+            disable_write_tools=disable_write_tools,
+            disable_search_tools=disable_search_tools,
+            host=host,
+            port=port,
+        )
+        dev_server.run(transport=transport)
+        return
+
     # Run the server
     server = HanzoMCPServer(
         name=name,