hanzo-mcp 0.1.21__py3-none-any.whl

hanzo_mcp-0.1.21.dist-info/METADATA

@@ -0,0 +1,168 @@
+Metadata-Version: 2.4
+Name: hanzo-mcp
+Version: 0.1.21
+Summary: MCP server for accessing Hanzo APIs and Platform capabilities
+Author-email: Hanzo Dev <dev@hanzo.ai>
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+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
+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"
+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"
+Dynamic: license-file
+
+# Hanzo MCP
+
+Hanzo AI + Platform capabilities via 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.
+
+![example](./doc/example.gif)
+
+## Features
+
+- **Code Understanding**: Analyze and understand codebases through file access and pattern searching
+- **Code Modification**: Make targeted edits to files with proper permission handling
+- **Enhanced Command Execution**: Run commands and scripts in various languages with improved error handling and shell support
+- **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
+- **Jupyter Notebook Support**: Read and edit Jupyter notebooks with full cell and output handling
+
+## Tools Implemented
+
+| Tool                   | Description                                                                                   |
+| ---------------------- | --------------------------------------------------------------------------------------------- |
+| `read_files`           | Read one or multiple files with encoding detection                                            |
+| `write_file`           | Create or overwrite files                                                                     |
+| `edit_file`            | Make line-based edits to text files                                                           |
+| `directory_tree`       | Get a recursive tree view of directories                                                      |
+| `get_file_info`        | Get metadata about a file or directory                                                        |
+| `search_content`       | Search for patterns in file contents                                                          |
+| `content_replace`      | Replace patterns in file contents                                                             |
+| `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                                         |
+| `think`                | Structured space for complex reasoning and analysis without making changes                    |
+
+## 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
+
+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.
+
+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:
+
+- 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
+
+This step is crucial as it enables Claude to follow a consistent approach when helping you with code modifications.
+
+## Security
+
+This implementation follows best practices for securing access to your filesystem:
+
+- Permission prompts for file modifications and command execution
+- Restricted access to specified directories only
+- Input validation and sanitization
+- Proper error handling and reporting
+
+## Development
+
+To contribute to this project:
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.

hanzo_mcp-0.1.21.dist-info/RECORD

@@ -0,0 +1,23 @@
+hanzo_mcp/__init__.py,sha256=b9ZjldZaFEU7nk4qZ6WCjl0fChLTeK18USOW84f7DXQ,98
+hanzo_mcp/cli.py,sha256=vDB-5trIp-tfKwRXosWVZGBNTZAo_B7wTCoF-NVaLKc,4747
+hanzo_mcp/server.py,sha256=p7-0B99gSfC5ieyOGt7xJ233ddCw1FY9dZDujaHarLU,4039
+hanzo_mcp/tools/__init__.py,sha256=IsjWWWAIQW4e490k3RI2YLQ46ZvDfcttqZ0SCcC6aps,2507
+hanzo_mcp/tools/common/__init__.py,sha256=mUlTy1Py8zV-DBEhkds-DoB2zHOxDZnbnOo3WFHP7ro,48
+hanzo_mcp/tools/common/context.py,sha256=BuuuHDQqzmO8LaWPcdgj8Md4FHT2gGuWIo8mN7fMIOY,12949
+hanzo_mcp/tools/common/permissions.py,sha256=HHH3MM-4dTufJ0HYv6M5yDJHJJBGjcXVnUi4lCWmfRI,7388
+hanzo_mcp/tools/common/thinking.py,sha256=0PRBTm8i8u0KBKfNaDasNSCn_R9kmFrAS3retEj_0J4,2630
+hanzo_mcp/tools/common/validation.py,sha256=S8zj38jjAXSB4bmZAydXDCsh_j6hHGEs71SgK-oeeYI,3652
+hanzo_mcp/tools/filesystem/__init__.py,sha256=IBrOsd_8yDo8RIuujB4rNQmr-JmXuddxyhOv-0PUeig,303
+hanzo_mcp/tools/filesystem/file_operations.py,sha256=6LeSoemvaz-oIP0K7GL_vySgA-i8QqN0tI9O_HalSIQ,46182
+hanzo_mcp/tools/jupyter/__init__.py,sha256=XuRoN_02X6ChW_OVGoPIydkQTOlvMtL5hPWRzGW3LVU,249
+hanzo_mcp/tools/jupyter/notebook_operations.py,sha256=AzZXyrgxR55KU09s3B1D50wAdsozHWQZFMCFXsnoe3A,23339
+hanzo_mcp/tools/project/__init__.py,sha256=el-n7xVnHgk6wXqVhFtFCoEfdq11aDAo9DucIJdXBVw,63
+hanzo_mcp/tools/project/analysis.py,sha256=eQ1WgeFNf_d9g_LWdo1f3x5-c4PLzRXK2_j-JN8wM9w,30366
+hanzo_mcp/tools/shell/__init__.py,sha256=myuuFc03I1xGq3VxmLddkSlvvaQIddA3WoIKds8ABFo,59
+hanzo_mcp/tools/shell/command_executor.py,sha256=HyhAwG-aLw13f0Z-K4sCAWqt7qRWEiixnv8tmTTyJW8,37401
+hanzo_mcp-0.1.21.dist-info/licenses/LICENSE,sha256=dvWmlLGUAkNE8EJVn-UQ-F08hxW5jtjUWNe51OaH7IE,1077
+hanzo_mcp-0.1.21.dist-info/METADATA,sha256=34AG2iCwxvRc2SXiGT8jqCgjH6Q8eiXM4YhfAE6OMSY,7094
+hanzo_mcp-0.1.21.dist-info/WHEEL,sha256=1tXe9gY0PYatrMPMDd6jXqjfpz_B-Wqm32CPfRC58XU,91
+hanzo_mcp-0.1.21.dist-info/entry_points.txt,sha256=aRKOKXtuQr-idSr-yH4efnRl2v8te94AcgN3ysqqSYs,49
+hanzo_mcp-0.1.21.dist-info/top_level.txt,sha256=eGFANatA0MHWiVlpS56fTYRIShtibrSom1uXI6XU0GU,10
+hanzo_mcp-0.1.21.dist-info/RECORD,,

hanzo_mcp-0.1.21.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (77.0.3)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

hanzo_mcp-0.1.21.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+hanzo-mcp = hanzo_mcp.cli:main

hanzo_mcp-0.1.21.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Hanzo Industries Inc
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+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.

hanzo_mcp-0.1.21.dist-info/top_level.txt

@@ -0,0 +1 @@
+hanzo_mcp