hanzo-mcp 0.1.21__py3-none-any.whl

hanzo_mcp/tools/common/thinking.py

@@ -0,0 +1,65 @@
+"""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."

hanzo_mcp/tools/common/validation.py

@@ -0,0 +1,124 @@
+"""Parameter validation utilities for Hanzo Dev MCP tools.
+
+This module provides utilities for validating parameters in tool functions.
+"""
+
+from typing import Any, TypeVar, final
+
+T = TypeVar("T")
+
+
+@final
+class ValidationResult:
+    """Result of a parameter validation."""
+
+    def __init__(self, is_valid: bool, error_message: str = ""):
+        """Initialize a validation result.
+
+        Args:
+            is_valid: Whether the parameter is valid
+            error_message: Optional error message for invalid parameters
+        """
+        self.is_valid: bool = is_valid
+        self.error_message: str = error_message
+
+    @property
+    def is_error(self) -> bool:
+        """Check if the validation resulted in an error.
+
+        Returns:
+            True if there was a validation error, False otherwise
+        """
+        return not self.is_valid
+
+
+def validate_parameter(
+    parameter: Any, parameter_name: str, allow_empty: bool = False
+) -> ValidationResult:
+    """Validate a single parameter.
+
+    Args:
+        parameter: The parameter value to validate
+        parameter_name: The name of the parameter (for error messages)
+        allow_empty: Whether to allow empty strings, lists, etc.
+
+    Returns:
+        A ValidationResult indicating whether the parameter is valid
+    """
+    # Check for None
+    if parameter is None:
+        return ValidationResult(
+            is_valid=False,
+            error_message=f"Parameter '{parameter_name}' is required but was None",
+        )
+
+    # Check for empty strings
+    if isinstance(parameter, str) and not allow_empty and parameter.strip() == "":
+        return ValidationResult(
+            is_valid=False,
+            error_message=f"Parameter '{parameter_name}' is required but was empty string",
+        )
+
+    # Check for empty collections
+    if (
+        isinstance(parameter, (list, tuple, dict, set))
+        and not allow_empty
+        and len(parameter) == 0
+    ):
+        return ValidationResult(
+            is_valid=False,
+            error_message=f"Parameter '{parameter_name}' is required but was empty {type(parameter).__name__}",
+        )
+
+    # Parameter is valid
+    return ValidationResult(is_valid=True)
+
+
+def validate_path_parameter(
+    path: str | None, parameter_name: str = "path"
+) -> ValidationResult:
+    """Validate a path parameter.
+
+    Args:
+        path: The path parameter to validate
+        parameter_name: The name of the parameter (for error messages)
+
+    Returns:
+        A ValidationResult indicating whether the parameter is valid
+    """
+    # Check for None
+    if path is None:
+        return ValidationResult(
+            is_valid=False,
+            error_message=f"Path parameter '{parameter_name}' is required but was None",
+        )
+
+    # Check for empty path
+    if path.strip() == "":
+        return ValidationResult(
+            is_valid=False,
+            error_message=f"Path parameter '{parameter_name}' is required but was empty string",
+        )
+
+    # Path is valid
+    return ValidationResult(is_valid=True)
+
+
+def validate_parameters(**kwargs: Any) -> ValidationResult:
+    """Validate multiple parameters.
+
+    Accepts keyword arguments where the key is the parameter name and the value is the parameter value.
+
+    Args:
+        **kwargs: Parameters to validate as name=value pairs
+
+    Returns:
+        A ValidationResult for the first invalid parameter, or a valid result if all are valid
+    """
+    for name, value in kwargs.items():
+        result = validate_parameter(value, name)
+        if result.is_error:
+            return result
+
+    # All parameters are valid
+    return ValidationResult(is_valid=True)

hanzo_mcp/tools/filesystem/__init__.py

@@ -0,0 +1,9 @@
+"""Filesystem tools for Hanzo Dev MCP.
+
+This module provides comprehensive tools for interacting with the filesystem,
+including reading, writing, editing files, directory operations, and searching.
+"""
+
+from hanzo_mcp.tools.filesystem.file_operations import FileOperations
+
+__all__ = ["FileOperations"]