hanzo-mcp 0.1.25__py3-none-any.whl → 0.1.32__py3-none-any.whl

{hanzo_mcp-0.1.25.dist-info → hanzo_mcp-0.1.32.dist-info}/METADATA

@@ -1,9 +1,13 @@
 Metadata-Version: 2.4
 Name: hanzo-mcp
-Version: 0.1.25
-Summary: MCP server for accessing Hanzo APIs and Platform capabilities
-Author-email: Hanzo <dev@hanzo.ai>
+Version: 0.1.32
+Summary: MCP implementation of Hanzo capabilities
+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://github.com/hanzoai/mcp/blob/main/README.md
+Keywords: mcp,claude,hanzo,code,agent
 Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
@@ -13,8 +17,9 @@ License-File: LICENSE
 Requires-Dist: mcp>=1.3.0
 Requires-Dist: httpx>=0.27.0
 Requires-Dist: uvicorn>=0.23.1
-Requires-Dist: mcp
-Requires-Dist: pytest
+Requires-Dist: openai>=1.50.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: litellm>=1.40.14
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
@@ -29,15 +34,18 @@ 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
 
-Hanzo AI + Platform capabilities via the Model Context Protocol (MCP).
+An implementation of Hanzo capabilities using the Model Context Protocol (MCP).
 
 ## Overview
 
-This project provides an MCP server that enables access to Hanzo APIs and Platform capabilities, as well as providing development tools for managing and improving projects. By leveraging the Model Context Protocol, this server enables seamless integration with various MCP clients including Claude Desktop, allowing LLMs to directly access Hanzo's platform functionality.
+This project provides an MCP server that implements Hanzo-like functionality, allowing Claude to directly execute instructions for modifying and improving project files. By leveraging the Model Context Protocol, this implementation enables seamless integration with various MCP clients including Claude Desktop.
 
 ![example](./doc/example.gif)
 
@@ -49,6 +57,8 @@ This project provides an MCP server that enables access to Hanzo APIs and Platfo
 - **File Operations**: Manage files with proper security controls through shell commands
 - **Code Discovery**: Find relevant files and code patterns across your project
 - **Project Analysis**: Understand project structure, dependencies, and frameworks
+- **Agent Delegation**: Delegate complex tasks to specialized sub-agents that can work concurrently
+- **Multiple LLM Provider Support**: Configure any LiteLLM-compatible model for agent operations
 - **Jupyter Notebook Support**: Read and edit Jupyter notebooks with full cell and output handling
 
 ## Tools Implemented
@@ -65,84 +75,27 @@ This project provides an MCP server that enables access to Hanzo APIs and Platfo
 | `run_command`          | Execute shell commands (also used for directory creation, file moving, and directory listing) |
 | `run_script`           | Execute scripts with specified interpreters                                                   |
 | `script_tool`          | Execute scripts in specific programming languages                                             |
-| `project_analyze_tool` | Analyze project structure and dependencies                                                   |
-| `read_notebook`        | Extract and read source code from all cells in a Jupyter notebook with outputs               |
-| `edit_notebook`        | Edit, insert, or delete cells in a Jupyter notebook                                         |
+| `project_analyze_tool` | Analyze project structure and dependencies                                                    |
+| `read_notebook`        | Extract and read source code from all cells in a Jupyter notebook with outputs                |
+| `edit_notebook`        | Edit, insert, or delete cells in a Jupyter notebook                                           |
 | `think`                | Structured space for complex reasoning and analysis without making changes                    |
+| `dispatch_agent`       | Launch one or more agents that can perform tasks using read-only tools concurrently           |
 
 ## Getting Started
 
-### Usage
-
-#### Configuring Claude Desktop
-
-You can run it with `uvx run hanzo-mcp` without installation. Configure Claude Desktop to use this server by adding the following to your Claude Desktop configuration file:
-
-```json
-{
-  "mcpServers": {
-    "hanzo": {
-      "command": "uvx",
-      "args": [
-        "--from",
-        "hanzo-mcp",
-        "hanzo-mcp",
-        "--allow-path",
-        "/path/to/your/project"
-      ]
-    }
-  }
-}
-```
-
-Make sure to replace `/path/to/your/project` with the actual path to the project you want Claude to access.
-
-#### Advanced Configuration Options
-
-You can customize the server using other options:
-
-```json
-{
-  "mcpServers": {
-    "hanzo": {
-      "command": "uvx",
-      "args": [
-        "--from",
-        "hanzo-mcp",
-        "hanzo-mcp",
-        "--allow-path",
-        "/path/to/project",
-        "--name",
-        "custom-hanzo",
-        "--transport",
-        "stdio"
-      ]
-    }
-  }
-}
-```
-
-### Configuring Claude Desktop System Prompt
+### Quick Install
 
-To get the best experience with Hanzo MCP, you need to add the provided system prompt to your Claude Desktop client. This system prompt guides Claude through a structured workflow for interacting with Hanzo platform services and managing project files.
+```bash
+# Install using uv
+uv pip install hanzo-mcp
 
-Follow these steps:
-
-1. Locate the system prompt file in this repository at `doc/system_prompt`
-2. Open your Claude Desktop client
-3. Create a new project or open an existing one
-4. Navigate to the "Project instructions" section in the Claude Desktop sidebar
-5. Copy the contents of `doc/system_prompt` and paste it into the "Project instructions" section
-6. Replace `{project_path}` with the actual absolute path to your project
-
-The system prompt provides Claude with:
+# Or using pip
+pip install hanzo-mcp
+```
 
-- A structured workflow for analyzing and modifying code
-- Best practices for project exploration and analysis
-- Guidelines for development, refactoring, and quality assurance
-- Special formatting instructions for mathematical content
+For detailed installation and configuration instructions, please refer to [INSTALL.md](./doc/INSTALL.md).
 
-This step is crucial as it enables Claude to follow a consistent approach when helping you with code modifications.
+Of course, you can also read [USEFUL_PROMPTS](./doc/USEFUL_PROMPTS.md) for some inspiration on how to use hanzo-mcp.
 
 ## Security
 
@@ -155,6 +108,59 @@ This implementation follows best practices for securing access to your filesyste
 
 ## Development
 
+### Setup Development Environment
+
+```bash
+# Clone the repository
+git clone https://github.com/hanzoai/mcp.git
+cd mcp
+
+# Install Python 3.13 using uv
+make install-python
+
+# Setup virtual environment and install dependencies
+make setup
+
+# Or install with development dependencies
+make install-dev
+```
+
+### Testing
+
+```bash
+# Run tests
+make test
+
+# Run tests with coverage
+make test-cov
+```
+
+### Building and Publishing
+
+```bash
+# Build package
+make build
+
+# Version bumping
+make bump-patch    # Increment patch version (0.1.x → 0.1.x+1)
+make bump-minor    # Increment minor version (0.x.0 → 0.x+1.0)
+make bump-major    # Increment major version (x.0.0 → x+1.0.0)
+
+# Publishing (creates git tag and pushes it to GitHub)
+make publish                     # Publish using configured credentials in .pypirc
+PYPI_TOKEN=your_token make publish  # Publish with token from environment variable
+
+# Version bump and publish in one step (with automatic git tagging)
+make publish-patch  # Bump patch version, publish, and create git tag
+make publish-minor  # Bump minor version, publish, and create git tag
+make publish-major  # Bump major version, publish, and create git tag
+
+# Publish to Test PyPI
+make publish-test
+```
+
+### Contributing
+
 To contribute to this project:
 
 1. Fork the repository

hanzo_mcp-0.1.32.dist-info/RECORD

@@ -0,0 +1,46 @@
+hanzo_mcp/__init__.py,sha256=Y5rIvHCEKCc1GKgt4XqjpEjZa91JOu3fSPnJZSBZJ70,89
+hanzo_mcp/cli.py,sha256=G0Klg7RMK9XLehLT9ysWbpii0XRrECglUaxwvCekl7g,7201
+hanzo_mcp/server.py,sha256=j2UagHTxwCbZrnhODbMUI0wdZ-7yLFxB9-ZbignZFzg,5671
+hanzo_mcp/tools/__init__.py,sha256=3IHzhmSiAbxg2yvqVJn4SH6YP_DSnxYaNk9ccBtk7H0,3339
+hanzo_mcp/tools/agent/__init__.py,sha256=0eyQqqdAy7WCZEqUfV6xh66bDpQI9neB6iDjWf0_pJI,2189
+hanzo_mcp/tools/agent/agent_tool.py,sha256=qXu62ZRGM0o9mxOiRVFy-ABIZtEJ8z03DqAXshKAieI,19180
+hanzo_mcp/tools/agent/prompt.py,sha256=jmYRI4Sm2D3LwEdC2qWakpqupgfGg8CT6grmx4NEDaA,4431
+hanzo_mcp/tools/agent/tool_adapter.py,sha256=g9NKfIET0WOsm0r28xEXsibsprpI1C6ripcM6QwU-rI,2172
+hanzo_mcp/tools/common/__init__.py,sha256=VS_eJP0oJGEgO78stwQWyer1heVfhhHihtt5sctjei8,809
+hanzo_mcp/tools/common/base.py,sha256=O7Lgft0XiC9Iyi3fYsmoWWrvKDK2Aa-FJLxPgnNJRJY,7341
+hanzo_mcp/tools/common/context.py,sha256=ReIfcm37j5qnLQ8G_-d88ad5uC1OKkjQZKG9HdJPybI,13145
+hanzo_mcp/tools/common/permissions.py,sha256=4YCfA2PJUOl-z_47n5uaRXO8gAZ_shMaPhpi1dilgRE,7594
+hanzo_mcp/tools/common/session.py,sha256=csX5ZhgBjO2bdXXXPpsUPzOCc7Tib-apYe01AP8sh8k,2774
+hanzo_mcp/tools/common/thinking_tool.py,sha256=I-O6ipM-PUofkNoMMzv37Y_2Yfx9mh7F1upTTsfRN4M,4046
+hanzo_mcp/tools/common/validation.py,sha256=gB3uM_cbPZsH4Ez0hnTgIcdP-AUlHZU02aRmZEpk_6I,3648
+hanzo_mcp/tools/common/version_tool.py,sha256=q6JVEyz-uWVJtCU_WY3TxE6aSLwlkIm0__mv4ZK43eY,1979
+hanzo_mcp/tools/filesystem/__init__.py,sha256=-wNhb0IjJgz05n_fRP0wDXfKgJ6fgBp4wrGo62Hpyvc,3265
+hanzo_mcp/tools/filesystem/base.py,sha256=HAzuMCrS0dKOBZNoLr7y74tdbYyKpi0FGhStuRgkFTU,3917
+hanzo_mcp/tools/filesystem/content_replace.py,sha256=ZwzxyOTASUmzP-jtEnsSR-MKtNFC4R3kQunpV3KOCyg,11049
+hanzo_mcp/tools/filesystem/directory_tree.py,sha256=cx-zpOeKP8DDuMt1ls3QhRk9h3RVmMhpPwpqn4wTfP4,11271
+hanzo_mcp/tools/filesystem/edit_file.py,sha256=03ku1_8X_uAUPfqGlR6fv55VEz-0Pifp9DJtkcOTFHY,10980
+hanzo_mcp/tools/filesystem/get_file_info.py,sha256=WR7uMqFcpKboS3FX3jF-MD-0-ROJJcppX7M_GtR0yLs,5392
+hanzo_mcp/tools/filesystem/read_files.py,sha256=0JYJ2kM8FIoksbnnO8V0uY3D2R1uWvR7zb7_oXV0sMM,6968
+hanzo_mcp/tools/filesystem/search_content.py,sha256=2zXke1YHYxg6GKQ_XHb0sXeaSkHI7Jx3P-YAqrpOTNM,10766
+hanzo_mcp/tools/filesystem/write_file.py,sha256=7ZNR1ygECBjT7m62QNkeIEt0OGxNZL2zijX-bASWj0Y,5303
+hanzo_mcp/tools/jupyter/__init__.py,sha256=xFYW8Idb4x1jLWbexN5sqFKSCd1aL820uENzJ7mb6rs,2282
+hanzo_mcp/tools/jupyter/base.py,sha256=xtssHrkHx_u_nE12dqtZGcvuJe8kfsbSkMmq-6KQobQ,10412
+hanzo_mcp/tools/jupyter/edit_notebook.py,sha256=_ZNlsCYaO9_SbZouvrLYElvssL6nlElCc2JxNCeMdQo,11986
+hanzo_mcp/tools/jupyter/notebook_operations.py,sha256=PkZXk_PYPkBGxg2RWzqh-rN6VDHjFybImhdUm3xLLoY,23120
+hanzo_mcp/tools/jupyter/read_notebook.py,sha256=54-i9MIaUiZGJndUPp2_-edTo3_j9WSgxXXoTmRCnlI,5656
+hanzo_mcp/tools/project/__init__.py,sha256=kMaSPyYT03qXqFL83nKdSz19-IzlrsVZTJk6YMgJOhw,2208
+hanzo_mcp/tools/project/analysis.py,sha256=9LFX_diDv6yYcqnY7tJQog4Sp3ZPrtm7EopnYJ3SPZo,30554
+hanzo_mcp/tools/project/base.py,sha256=CniLAsjum5vC3cgvF9AqU-_ZY_0Nf9uaF2L_xV2obxE,1948
+hanzo_mcp/tools/project/project_analyze.py,sha256=6GLE_JcSiCy6kKdee0sMI5T2229A-Vpp98s2j_JD6yI,5711
+hanzo_mcp/tools/shell/__init__.py,sha256=lKgh0WXds4tZJ1tIL9MJbyMSzP6A9uZQALjGGBvyYc4,1679
+hanzo_mcp/tools/shell/base.py,sha256=OxKNWMp-fB-vozzWOE_hHvr5M_pFKSMIYfOX0dEOWzA,4836
+hanzo_mcp/tools/shell/command_executor.py,sha256=5GcJvg54uty9fl_tkGdWTBcHyjxuynQZ_Tv6qOyKgdk,32616
+hanzo_mcp/tools/shell/run_command.py,sha256=r7HBw0lqabgkGnVsDXmLnrTo0SU9g8gLvzpa-9n-cmM,6891
+hanzo_mcp/tools/shell/run_script.py,sha256=CLYnDc0Ze8plkXU6d98RgE4UrBg-fwaMVdcn9Fc6Ixw,7432
+hanzo_mcp/tools/shell/script_tool.py,sha256=s63tawIZBvwgm_kU9P7A3D4v2ulVw7j4l_rpsa_zGuc,8680
+hanzo_mcp-0.1.32.dist-info/licenses/LICENSE,sha256=mf1qZGFsPGskoPgytp9B-RsahfKvXsBpmaAbTLGTt8Y,1063
+hanzo_mcp-0.1.32.dist-info/METADATA,sha256=FvKaHStWB3J_-pMcwBGM0c21MxyQfvgMd4Ek3lQHjMg,7277
+hanzo_mcp-0.1.32.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
+hanzo_mcp-0.1.32.dist-info/entry_points.txt,sha256=aRKOKXtuQr-idSr-yH4efnRl2v8te94AcgN3ysqqSYs,49
+hanzo_mcp-0.1.32.dist-info/top_level.txt,sha256=eGFANatA0MHWiVlpS56fTYRIShtibrSom1uXI6XU0GU,10
+hanzo_mcp-0.1.32.dist-info/RECORD,,

{hanzo_mcp-0.1.25.dist-info → hanzo_mcp-0.1.32.dist-info}/licenses/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Hanzo Industries Inc
+Copyright (c) 2025 hanzoai
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -18,4 +18,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.

hanzo_mcp/tools/common/thinking.py

@@ -1,65 +0,0 @@
-"""Thinking tool for Hanzo MCP.
-
-This module provides a tool for Claude to engage in structured thinking
-when performing complex multi-step operations or reasoning through policies.
-Following the pattern described in Anthropic's "Claude Think Tool" article.
-"""
-
-from typing import final
-
-from mcp.server.fastmcp import Context as MCPContext
-from mcp.server.fastmcp import FastMCP
-
-from hanzo_mcp.tools.common.context import create_tool_context
-
-
-@final
-class ThinkingTool:
-    """Think tool for Hanzo MCP.
-
-    This class provides a "think" tool that enables Claude to engage in more structured
-    thinking when processing complex information or making multi-step decisions.
-    """
-
-    def __init__(self) -> None:
-        """Initialize the thinking tool."""
-        pass
-
-    def register_tools(self, mcp_server: FastMCP) -> None:
-        """Register thinking tools with the MCP server.
-
-        Args:
-            mcp_server: The FastMCP server instance
-        """
-
-        @mcp_server.tool()
-        async def think(thought: str, ctx: MCPContext) -> str:
-            """Use the tool to think about something.
-
-            It will not obtain new information or make any changes to the repository, but just log the thought. Use it when complex reasoning or brainstorming is needed. For example, if you explore the repo and discover the source of a bug, call this tool to brainstorm several unique ways of fixing the bug, and assess which change(s) are likely to be simplest and most effective. Alternatively, if you receive some test results, call this tool to brainstorm ways to fix the failing tests.
-
-            Args:
-                thought: Your thoughts or analysis
-
-            Returns:
-                Confirmation that the thinking process has been recorded
-            """
-            tool_ctx = create_tool_context(ctx)
-            tool_ctx.set_tool_info("think")
-
-            # Validate required thought parameter
-            if not thought:
-                await tool_ctx.error(
-                    "Parameter 'thought' is required but was None or empty"
-                )
-                return "Error: Parameter 'thought' is required but was None or empty"
-
-            if thought.strip() == "":
-                await tool_ctx.error("Parameter 'thought' cannot be empty")
-                return "Error: Parameter 'thought' cannot be empty"
-
-            # Log the thought but don't take action
-            await tool_ctx.info("Thinking process recorded")
-
-            # Return confirmation
-            return "I've recorded your thinking process. You can continue with your next action based on this analysis."