hanzo-mcp 0.6.13__tar.gz → 0.7.1__tar.gz

{hanzo_mcp-0.6.13 → hanzo_mcp-0.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hanzo-mcp
-Version: 0.6.13
+Version: 0.7.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
@@ -13,7 +13,6 @@ 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.9.4
 Requires-Dist: fastmcp>=2.9.2
 Requires-Dist: httpx>=0.28.1
@@ -30,6 +29,7 @@ Requires-Dist: pydantic>=2.11.1
 Requires-Dist: pydantic-settings>=2.7.0
 Requires-Dist: typing-extensions>=4.13.0
 Requires-Dist: watchdog>=6.0.0
+Requires-Dist: keyring>=24.0.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
@@ -44,6 +44,8 @@ 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: analytics
+Requires-Dist: posthog>=3.0.0; extra == "analytics"
 Provides-Extra: test
 Requires-Dist: pytest>=7.0.0; extra == "test"
 Requires-Dist: pytest-cov>=4.1.0; extra == "test"
@@ -56,7 +58,6 @@ 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 AI - The Zen of Model Context Protocol
 
@@ -66,11 +67,11 @@ Dynamic: license-file
 [![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
+## 🥷 The Complete AI Development Ecosystem via MCP
 
-**Start here. Add other MCPs later. Control everything through one opinionated interface.**
+**One unified interface to orchestrate your entire development workflow.**
 
-Hanzo AI 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.
+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
@@ -82,23 +83,110 @@ uvx hanzo-mcp
 
 > **Note on Installation**: If uvx is not installed, Hanzo will automatically install it for you in your home directory. No manual setup required!
 
-## 🎯 Why Hanzo AI?
+## 🌐 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 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
-- **Missing Quality Control**: No built-in code review or quality assurance
+**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
 
-### The Hanzo Way
-- **One Installation**: 70+ professional tools out of the box
-- **Consistent Philosophy**: Unix-inspired principles with modern AI capabilities
-- **MCP Orchestration**: Install and control other MCP servers through Hanzo
-- **Built-in Quality**: Critic tool ensures high standards automatically
-- **Smart Defaults**: Auto-installs dependencies, reads project rules, just works
+## 🚀 Core Capabilities
 
-## 🚀 Modern AI-Powered Features
+### 📓 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
 
@@ -154,27 +242,50 @@ todo --action update --id abc123 --status in_progress
 todo --action list --filter pending
 ```
 
-### 🔍 Next-Gen Search
+### 🔍 Intelligent Code Intelligence
 
 #### Unified Search Engine
 ```python
-# One search to rule them all - automatically runs:
-# - Grep for patterns
+# 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
-# - Symbol search for definitions
+# - Git history search (integrated into git tool)
+# - Symbol search with LSP
+# - Memory search for past discussions
 search("authentication flow")
 ```
 
-#### AST-Powered Code Navigation
+#### 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
-# Find code with structural understanding
-symbols --action grep_ast --pattern "TODO" --path ./src
-# Shows TODO comments with full code context:
-# - What function they're in
-# - What class they belong to
-# - Related code structure
+# 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
@@ -205,42 +316,51 @@ their_tool(action="whatever", params=...)
 mcp --action remove --alias "their"
 ```
 
-## 🛠️ Complete Tool Suite
+## 🛠️ 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
 
-### Core Development (Always Available)
+### 🔍 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
-- **search** - Multi-modal parallel search
-- **symbols** - AST-aware code navigation with grep_ast
 - **tree** - Visual directory structures
-- **grep** - Fast pattern matching
-- **rules** - Read project preferences
-
-### AI & Automation
-- **agent** - Delegate complex multi-step tasks
-- **consensus** - Multi-LLM agreement
-- **think** - Structured reasoning
-- **critic** - Code review and quality enforcement
+- **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
 
-### Process & System
-- **bash** - Secure command execution
+### 🖥️ System & Process
+- **bash** - Command execution with session management
 - **npx/uvx** - Package runners with auto-install
 - **process** - Background process management
-- **watch** - File monitoring
-- **diff** - Visual comparisons
+- **git** - Complete git integration with search
 
-### Data & Analytics
-- **vector_index/vector_search** - Semantic search
-- **sql_query/sql_search** - Database operations
-- **graph_add/graph_query** - Graph database
-- **jupyter** - Notebook integration
-- **stats** - Performance analytics
+### 📊 Data & Analytics
+- **vector** - Semantic search and indexing
+- **sql** - Database operations and queries
+- **graph** - Graph database operations
+- **stats** - Performance and usage analytics
 
-### Collaboration
+### 🎯 Project Management
 - **todo** - Unified task management
-- **palette** - Tool configuration sets
-- **mcp** - Server orchestration
-- **git_search** - Repository mining
+- **rules** - Project preferences discovery
+- **palette** - Tool configuration presets
+- **mcp** - Dynamic MCP server orchestration
 
 ## 🚀 Quick Start
 
@@ -276,25 +396,62 @@ curl -LsSf https://pypi.org/simple/hanzo-mcp | python3
 }
 ```
 
+## 🔗 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 (uvx, uv, etc.)
+- **Auto-installs** missing dependencies and language servers
 - **Discovers** project rules and preferences automatically
-- **Parallel** operations by default
+- **Parallel** operations by default for speed
 - **Intelligent** fallbacks when tools aren't available
 
 ### Quality First
-- **Built-in critic** for code review
-- **Test enforcement** in workflows
+- **Built-in critic** for automated code review
+- **Test enforcement** in all workflows
 - **Security scanning** in operations
-- **Best practices** baked in
+- **Best practices** enforced by default
 
-### Extensible
+### Truly Extensible
 - **Palette system** for instant context switching
-- **MCP orchestration** to add any capability
+- **MCP orchestration** to add any server dynamically
 - **Plugin architecture** for custom tools
-- **API-first** design
+- **Everything is an API** for maximum flexibility
 
 ## 📊 Performance
 
@@ -331,11 +488,12 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
 
 ## 📈 Project Status
 
-- **Version**: 0.6.x (Stable)
-- **Tools**: 70+ and growing
-- **Palettes**: 10 built-in, unlimited custom
-- **Community**: Active and helpful
-- **Updates**: Weekly improvements
+- **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