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

hanzo_mcp/tools/filesystem/search_content.py

@@ -0,0 +1,275 @@
+"""Search content tool implementation.
+
+This module provides the SearchContentTool for finding text patterns in files.
+"""
+
+import asyncio
+import fnmatch
+import re
+from pathlib import Path
+from typing import Any, final, override
+
+from mcp.server.fastmcp import Context as MCPContext
+from mcp.server.fastmcp import FastMCP
+
+from hanzo_mcp.tools.filesystem.base import FilesystemBaseTool
+
+
+@final
+class SearchContentTool(FilesystemBaseTool):
+    """Tool for searching for text patterns in files."""
+    
+    @property
+    @override
+    def name(self) -> str:
+        """Get the tool name.
+        
+        Returns:
+            Tool name
+        """
+        return "search_content"
+        
+    @property
+    @override
+    def description(self) -> str:
+        """Get the tool description.
+        
+        Returns:
+            Tool description
+        """
+        return """Search for a pattern in file contents.
+
+Similar to grep, this tool searches for text patterns within files.
+Searches recursively through all files in the specified directory
+that match the file pattern. Returns matching lines with file and
+line number references. Only searches within allowed directories."""
+        
+    @property
+    @override
+    def parameters(self) -> dict[str, Any]:
+        """Get the parameter specifications for the tool.
+        
+        Returns:
+            Parameter specifications
+        """
+        return {
+            "properties": {
+                "pattern": {
+                    "type": "string",
+                    "description": "text pattern to search for"
+                },
+                "path": {
+                    "type": "string",
+                    "description": "path to the directory or file to search"
+                },
+                "file_pattern": {
+                    "default": "*",
+                    "type": "string"
+                }
+            },
+            "required": ["pattern", "path"],
+            "title": "search_contentArguments",
+            "type": "object"
+        }
+        
+    @property
+    @override
+    def required(self) -> list[str]:
+        """Get the list of required parameter names.
+        
+        Returns:
+            List of required parameter names
+        """
+        return ["pattern", "path"]
+        
+    @override
+    async def call(self, ctx: MCPContext, **params: Any) -> str:
+        """Execute the tool with the given parameters.
+        
+        Args:
+            ctx: MCP context
+            **params: Tool parameters
+            
+        Returns:
+            Tool result
+        """
+        tool_ctx = self.create_tool_context(ctx)
+        
+        # Extract parameters
+        pattern = params.get("pattern")
+        path = params.get("path")
+        file_pattern = params.get("file_pattern", "*")  # Default to all files
+        
+        # Validate required parameters
+        if not pattern:
+            await tool_ctx.error("Parameter 'pattern' is required but was None")
+            return "Error: Parameter 'pattern' is required but was None"
+
+        if pattern.strip() == "":
+            await tool_ctx.error("Parameter 'pattern' cannot be empty")
+            return "Error: Parameter 'pattern' cannot be empty"
+
+        if not path:
+            await tool_ctx.error("Parameter 'path' is required but was None")
+            return "Error: Parameter 'path' is required but was None"
+
+        if path.strip() == "":
+            await tool_ctx.error("Parameter 'path' cannot be empty")
+            return "Error: Parameter 'path' cannot be empty"
+
+
+        path_validation = self.validate_path(path)
+        if path_validation.is_error:
+            await tool_ctx.error(path_validation.error_message)
+            return f"Error: {path_validation.error_message}"
+
+        # file_pattern can be None safely as it has a default value
+
+        await tool_ctx.info(
+            f"Searching for pattern '{pattern}' in files matching '{file_pattern}' in {path}"
+        )
+
+        # Check if path is allowed
+        allowed, error_msg = await self.check_path_allowed(path, tool_ctx)
+        if not allowed:
+            return error_msg
+
+        try:
+            input_path = Path(path)
+
+            # Check if path exists
+            exists, error_msg = await self.check_path_exists(path, tool_ctx)
+            if not exists:
+                return error_msg
+
+            # Find matching files using optimized file finding
+            matching_files: list[Path] = []
+
+            # Process based on whether path is a file or directory
+            if input_path.is_file():
+                # Single file search
+                if file_pattern == "*" or fnmatch.fnmatch(input_path.name, file_pattern):
+                    matching_files.append(input_path)
+                    await tool_ctx.info(f"Searching single file: {path}")
+                else:
+                    await tool_ctx.info(f"File does not match pattern '{file_pattern}': {path}")
+                    return f"File does not match pattern '{file_pattern}': {path}"
+            elif input_path.is_dir():
+                # Directory search - optimized file finding
+                await tool_ctx.info(f"Finding files in directory: {path}")
+                
+                # Keep track of allowed paths for filtering
+                allowed_paths: set[str] = set()
+                
+                # Collect all allowed paths first for faster filtering
+                for entry in input_path.rglob("*"):
+                    entry_path = str(entry)
+                    if self.is_path_allowed(entry_path):
+                        allowed_paths.add(entry_path)
+                
+                # Find matching files efficiently
+                for entry in input_path.rglob("*"):
+                    entry_path = str(entry)
+                    if entry_path in allowed_paths and entry.is_file():
+                        if file_pattern == "*" or fnmatch.fnmatch(entry.name, file_pattern):
+                            matching_files.append(entry)
+                
+                await tool_ctx.info(f"Found {len(matching_files)} matching files")
+            else:
+                # This shouldn't happen since we already checked for existence
+                await tool_ctx.error(f"Path is neither a file nor a directory: {path}")
+                return f"Error: Path is neither a file nor a directory: {path}"
+
+            # Report progress
+            total_files = len(matching_files)
+            if input_path.is_file():
+                await tool_ctx.info(f"Searching file: {path}")
+            else:
+                await tool_ctx.info(f"Searching through {total_files} files in directory")
+
+            # set up for parallel processing
+            results: list[str] = []
+            files_processed = 0
+            matches_found = 0
+            batch_size = 20  # Process files in batches to avoid overwhelming the system
+            
+            # Use a semaphore to limit concurrent file operations
+            # Adjust the value based on system resources
+            semaphore = asyncio.Semaphore(10)
+            
+            # Create an async function to search a single file
+            async def search_file(file_path: Path) -> list[str]:
+                nonlocal files_processed, matches_found
+                file_results: list[str] = []
+                
+                try:
+                    async with semaphore:  # Limit concurrent operations
+                        try:
+                            with open(file_path, "r", encoding="utf-8") as f:
+                                for line_num, line in enumerate(f, 1):
+                                    if re.search(pattern, line):
+                                        file_results.append(
+                                            f"{file_path}:{line_num}: {line.rstrip()}"
+                                        )
+                                        matches_found += 1
+                            files_processed += 1
+                        except UnicodeDecodeError:
+                            # Skip binary files
+                            files_processed += 1
+                        except Exception as e:
+                            await tool_ctx.warning(f"Error reading {file_path}: {str(e)}")
+                except Exception as e:
+                    await tool_ctx.warning(f"Error processing {file_path}: {str(e)}")
+                    
+                return file_results
+
+            # Process files in parallel batches
+            for i in range(0, len(matching_files), batch_size):
+                batch = matching_files[i:i+batch_size]
+                batch_tasks = [search_file(file_path) for file_path in batch]
+                
+                # Report progress
+                await tool_ctx.report_progress(i, total_files)
+                
+                # Wait for the batch to complete
+                batch_results = await asyncio.gather(*batch_tasks)
+                
+                # Flatten and collect results
+                for file_result in batch_results:
+                    results.extend(file_result)
+
+            # Final progress report
+            await tool_ctx.report_progress(total_files, total_files)
+
+            if not results:
+                if input_path.is_file():
+                    return f"No matches found for pattern '{pattern}' in file: {path}"
+                else:
+                    return f"No matches found for pattern '{pattern}' in files matching '{file_pattern}' in directory: {path}"
+
+            await tool_ctx.info(
+                f"Found {matches_found} matches in {files_processed} file{'s' if files_processed > 1 else ''}"
+            )
+            return (
+                f"Found {matches_found} matches in {files_processed} file{'s' if files_processed > 1 else ''}:\n\n"
+                + "\n".join(results)
+            )
+        except Exception as e:
+            await tool_ctx.error(f"Error searching file contents: {str(e)}")
+            return f"Error searching file contents: {str(e)}"
+            
+    @override
+    def register(self, mcp_server: FastMCP) -> None:
+        """Register this search content tool with the MCP server.
+        
+        Creates a wrapper function with explicitly defined parameters that match
+        the tool's parameter schema and registers it with the MCP server.
+        
+        Args:
+            mcp_server: The FastMCP server instance
+        """
+        tool_self = self  # Create a reference to self for use in the closure
+        
+        @mcp_server.tool(name=self.name, description=self.mcp_description)
+        async def search_content(ctx: MCPContext, pattern: str, path: str, file_pattern: str = "*") -> str:
+            return await tool_self.call(ctx, pattern=pattern, path=path, file_pattern=file_pattern)

hanzo_mcp/tools/filesystem/write_file.py

@@ -0,0 +1,162 @@
+"""Write file tool implementation.
+
+This module provides the WriteFileTool for creating or overwriting files.
+"""
+
+from pathlib import Path
+from typing import Any, final, override
+
+from mcp.server.fastmcp import Context as MCPContext
+from mcp.server.fastmcp import FastMCP
+
+from hanzo_mcp.tools.filesystem.base import FilesystemBaseTool
+
+
+@final
+class WriteFileTool(FilesystemBaseTool):
+    """Tool for writing file contents."""
+    
+    @property
+    @override
+    def name(self) -> str:
+        """Get the tool name.
+        
+        Returns:
+            Tool name
+        """
+        return "write_file"
+        
+    @property
+    @override
+    def description(self) -> str:
+        """Get the tool description.
+        
+        Returns:
+            Tool description
+        """
+        return """Create a new file or completely overwrite an existing file with new content.
+
+Use with caution as it will overwrite existing files without warning.
+Handles text content with proper encoding. Only works within allowed directories."""
+        
+    @property
+    @override
+    def parameters(self) -> dict[str, Any]:
+        """Get the parameter specifications for the tool.
+        
+        Returns:
+            Parameter specifications
+        """
+        return {
+            "properties": {
+                "path": {
+                    "type": "string",
+                    "description": "path to the file to write"
+                },
+                "content": {
+                    "type": "string",
+                    "description": "content to write to the file"
+                }
+            },
+            "required": ["path", "content"],
+            "type": "object"
+        }
+        
+    @property
+    @override
+    def required(self) -> list[str]:
+        """Get the list of required parameter names.
+        
+        Returns:
+            List of required parameter names
+        """
+        return ["path", "content"]
+        
+    @override
+    async def call(self, ctx: MCPContext, **params: Any) -> str:
+        """Execute the tool with the given parameters.
+        
+        Args:
+            ctx: MCP context
+            **params: Tool parameters
+            
+        Returns:
+            Tool result
+        """
+        tool_ctx = self.create_tool_context(ctx)
+        self.set_tool_context_info(tool_ctx)
+        
+        # Extract parameters
+        path = params.get("path")
+        content = params.get("content")
+
+        if not path:
+            await tool_ctx.error("Parameter 'path' is required but was None")
+            return "Error: Parameter 'path' is required but was None"
+
+        if path.strip() == "":
+            await tool_ctx.error("Parameter 'path' cannot be empty")
+            return "Error: Parameter 'path' cannot be empty"
+
+        # Validate parameters
+        path_validation = self.validate_path(path)
+        if path_validation.is_error:
+            await tool_ctx.error(path_validation.error_message)
+            return f"Error: {path_validation.error_message}"
+
+        if not content:
+            await tool_ctx.error("Parameter 'content' is required but was None")
+            return "Error: Parameter 'content' is required but was None"
+
+        await tool_ctx.info(f"Writing file: {path}")
+
+        # Check if file is allowed to be written
+        allowed, error_msg = await self.check_path_allowed(path, tool_ctx)
+        if not allowed:
+            return error_msg
+
+        # Additional check already verified by is_path_allowed above
+        await tool_ctx.info(f"Writing file: {path}")
+
+        try:
+            file_path = Path(path)
+
+            # Check if parent directory is allowed
+            parent_dir = str(file_path.parent)
+            if not self.is_path_allowed(parent_dir):
+                await tool_ctx.error(f"Parent directory not allowed: {parent_dir}")
+                return f"Error: Parent directory not allowed: {parent_dir}"
+
+            # Create parent directories if they don't exist
+            file_path.parent.mkdir(parents=True, exist_ok=True)
+
+            # Write the file
+            with open(file_path, "w", encoding="utf-8") as f:
+                f.write(content)
+
+            # Add to document context
+            self.document_context.add_document(path, content)
+
+            await tool_ctx.info(
+                f"Successfully wrote file: {path} ({len(content)} bytes)"
+            )
+            return f"Successfully wrote file: {path} ({len(content)} bytes)"
+        except Exception as e:
+            await tool_ctx.error(f"Error writing file: {str(e)}")
+            return f"Error writing file: {str(e)}"
+            
+    @override
+    def register(self, mcp_server: FastMCP) -> None:
+        """Register this tool with the MCP server.
+        
+        Creates a wrapper function with explicitly defined parameters that match
+        the tool's parameter schema and registers it with the MCP server.
+        
+        Args:
+            mcp_server: The FastMCP server instance
+        """
+        tool_self = self  # Create a reference to self for use in the closure
+        
+        @mcp_server.tool(name=self.name, description=self.mcp_description)
+        async def write_file(path: str, content: str, ctx: MCPContext) -> str:
+            return await tool_self.call(ctx, path=path, content=content)

hanzo_mcp/tools/jupyter/__init__.py

@@ -1,8 +1,71 @@
-"""Jupyter notebook tools for Hanzo MCP.
+"""Jupyter notebook tools package for Hanzo MCP.
 
-This module provides tools for reading and editing Jupyter notebooks (.ipynb files).
+This package provides tools for working with Jupyter notebooks (.ipynb files),
+including reading and editing notebook cells.
 """
 
-from hanzo_mcp.tools.jupyter.notebook_operations import JupyterNotebookTools
+from mcp.server.fastmcp import FastMCP
 
-__all__ = ["JupyterNotebookTools"]
+from hanzo_mcp.tools.common.base import BaseTool, ToolRegistry
+from hanzo_mcp.tools.common.context import DocumentContext
+from hanzo_mcp.tools.common.permissions import PermissionManager
+from hanzo_mcp.tools.jupyter.edit_notebook import EditNotebookTool
+from hanzo_mcp.tools.jupyter.read_notebook import ReadNotebookTool
+
+# Export all tool classes
+__all__ = [
+    "ReadNotebookTool",
+    "EditNotebookTool",
+    "get_jupyter_tools",
+    "register_jupyter_tools",
+]
+
+def get_read_only_jupyter_tools(
+    document_context: DocumentContext, permission_manager: PermissionManager
+) -> list[BaseTool]:
+    """Create instances of read only Jupyter notebook tools.
+    
+    Args:
+        document_context: Document context for tracking file contents
+        permission_manager: Permission manager for access control
+        
+    Returns:
+        List of Jupyter notebook tool instances
+    """
+    return [
+        ReadNotebookTool(document_context, permission_manager),
+    ]
+
+
+def get_jupyter_tools(
+    document_context: DocumentContext, permission_manager: PermissionManager
+) -> list[BaseTool]:
+    """Create instances of all Jupyter notebook tools.
+    
+    Args:
+        document_context: Document context for tracking file contents
+        permission_manager: Permission manager for access control
+        
+    Returns:
+        List of Jupyter notebook tool instances
+    """
+    return [
+        ReadNotebookTool(document_context, permission_manager),
+        EditNotebookTool(document_context, permission_manager),
+    ]
+
+
+def register_jupyter_tools(
+    mcp_server: FastMCP,
+    document_context: DocumentContext,
+    permission_manager: PermissionManager,
+) -> None:
+    """Register all Jupyter notebook tools with the MCP server.
+    
+    Args:
+        mcp_server: The FastMCP server instance
+        document_context: Document context for tracking file contents
+        permission_manager: Permission manager for access control
+    """
+    tools = get_jupyter_tools(document_context, permission_manager)
+    ToolRegistry.register_tools(mcp_server, tools)