hanzo-mcp 0.3.1__tar.gz → 0.3.4__tar.gz

{hanzo_mcp-0.3.1 → hanzo_mcp-0.3.4}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: hanzo-mcp
-Version: 0.3.1
+Version: 0.3.4
 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
+Project-URL: Documentation, https://github.com/hanzoai/mcp/tree/main/docs
 Keywords: mcp,claude,hanzo,code,agent
 Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: MIT License
@@ -25,6 +25,9 @@ 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"
+Requires-Dist: sphinx>=8.0.0; extra == "dev"
+Requires-Dist: sphinx-rtd-theme>=1.3.0; extra == "dev"
+Requires-Dist: myst-parser>=2.0.0; extra == "dev"
 Provides-Extra: test
 Requires-Dist: pytest>=7.0.0; extra == "test"
 Requires-Dist: pytest-cov>=4.1.0; extra == "test"
@@ -93,7 +96,7 @@ uv pip install hanzo-mcp
 pip install hanzo-mcp
 ```
 
-For detailed installation and configuration instructions, please refer to [INSTALL.md](./doc/INSTALL.md).
+For detailed installation and configuration instructions, please refer to the [documentation](./docs/).
 
 Of course, you can also read [USEFUL_PROMPTS](./doc/USEFUL_PROMPTS.md) for some inspiration on how to use hanzo-mcp.
 
@@ -106,6 +109,20 @@ This implementation follows best practices for securing access to your filesyste
 - Input validation and sanitization
 - Proper error handling and reporting
 
+## Documentation
+
+Comprehensive documentation is available in the [docs](./docs/) directory. You can build and view the documentation locally:
+
+```bash
+# Build the documentation
+make docs
+
+# Start a local server to view the documentation
+make docs-serve
+```
+
+Then open http://localhost:8000/ in your browser to view the documentation.
+
 ## Development
 
 ### Setup Development Environment

{hanzo_mcp-0.3.1 → hanzo_mcp-0.3.4}/README.md

@@ -52,7 +52,7 @@ uv pip install hanzo-mcp
 pip install hanzo-mcp
 ```
 
-For detailed installation and configuration instructions, please refer to [INSTALL.md](./doc/INSTALL.md).
+For detailed installation and configuration instructions, please refer to the [documentation](./docs/).
 
 Of course, you can also read [USEFUL_PROMPTS](./doc/USEFUL_PROMPTS.md) for some inspiration on how to use hanzo-mcp.
 
@@ -65,6 +65,20 @@ This implementation follows best practices for securing access to your filesyste
 - Input validation and sanitization
 - Proper error handling and reporting
 
+## Documentation
+
+Comprehensive documentation is available in the [docs](./docs/) directory. You can build and view the documentation locally:
+
+```bash
+# Build the documentation
+make docs
+
+# Start a local server to view the documentation
+make docs-serve
+```
+
+Then open http://localhost:8000/ in your browser to view the documentation.
+
 ## Development
 
 ### Setup Development Environment

{hanzo_mcp-0.3.1 → hanzo_mcp-0.3.4}/hanzo_mcp/__init__.py

@@ -1,3 +1,3 @@
 """Hanzo MCP - Implementation of Hanzo capabilities using MCP."""
 
-__version__ = "0.3.1"
+__version__ = "0.3.4"

{hanzo_mcp-0.3.1 → hanzo_mcp-0.3.4}/hanzo_mcp/cli.py

@@ -133,6 +133,14 @@ def main() -> None:
         default=False,
         help="Disable logging to file (logs to console only)"
     )
+    
+    _ = parser.add_argument(
+        "--enable-console-logging",
+        dest="enable_console_logging",
+        action="store_true",
+        default=False,
+        help="Enable logging to console (stdout/stderr). By default, logs to file only."
+    )
 
     _ = parser.add_argument(
         "--disable-write-tools",
@@ -166,13 +174,25 @@ def main() -> None:
     disable_write_tools: bool = cast(bool, args.disable_write_tools)
     log_level: str = cast(str, args.log_level)
     disable_file_logging: bool = cast(bool, args.disable_file_logging)
+    enable_console_logging: bool = cast(bool, args.enable_console_logging)
     allowed_paths: list[str] = (
         cast(list[str], args.allowed_paths) if args.allowed_paths else []
     )
 
     # Setup logging
-    setup_logging(log_level=log_level, log_to_file=not disable_file_logging, testing="pytest" in sys.modules)
-    logger.debug(f"Hanzo MCP CLI started with arguments: {args}")
+    # Ensure absolutely NO logging when using stdio transport to avoid protocol corruption
+    # For sse transport, use file logging by default and console logging only if explicitly requested
+    # Only set up logging if not using stdio transport or explicitly requested
+    if transport != "stdio" or (enable_console_logging or not disable_file_logging):
+        setup_logging(
+            log_level=log_level,
+            log_to_file=not disable_file_logging and transport != "stdio",  # Disable file logging for stdio transport
+            log_to_console=enable_console_logging and transport != "stdio",  # Only enable console logging if requested AND not using stdio
+            transport=transport,  # Pass the transport to ensure it's properly handled
+            testing="pytest" in sys.modules
+        )
+        logger.debug(f"Hanzo MCP CLI started with arguments: {args}")
+    # No logging setup at all for stdio transport unless explicitly requested
 
 
     if install:
@@ -200,10 +220,11 @@ def main() -> None:
     elif allowed_paths:
         project_dir = allowed_paths[0]
 
-    # Run the server
-    logger.info(f"Starting Hanzo MCP server with name: {name}")
-    logger.debug(f"Allowed paths: {allowed_paths}")
-    logger.debug(f"Project directory: {project_dir}")
+    # Run the server - only log if not using stdio transport or logging is explicitly enabled
+    if transport != "stdio" or (enable_console_logging or not disable_file_logging):
+        logger.info(f"Starting Hanzo MCP server with name: {name}")
+        logger.debug(f"Allowed paths: {allowed_paths}")
+        logger.debug(f"Project directory: {project_dir}")
 
     try:
         server = HanzoServer(
@@ -220,12 +241,19 @@ def main() -> None:
             host=host,
             port=port
         )
-        logger.info(f"Server initialized successfully, running with transport: {transport}")
+        
+        # Only log if not using stdio transport or logging is explicitly enabled
+        if transport != "stdio" or (enable_console_logging or not disable_file_logging):
+            logger.info(f"Server initialized successfully, running with transport: {transport}")
+            
         # Transport will be automatically cast to Literal['stdio', 'sse'] by the server
         server.run(transport=transport)
     except Exception as e:
-        logger.error(f"Error starting server: {str(e)}")
-        logger.exception("Server startup failed with exception:")
+        # Only log if not using stdio transport or logging is explicitly enabled
+        if transport != "stdio" or (enable_console_logging or not disable_file_logging):
+            logger.error(f"Error starting server: {str(e)}")
+            logger.exception("Server startup failed with exception:")
+        # For stdio transport, we want a clean exception without any logging
         # Re-raise the exception for proper error handling
         raise
 

{hanzo_mcp-0.3.1 → hanzo_mcp-0.3.4}/hanzo_mcp/tools/common/logging_config.py

@@ -8,14 +8,23 @@ import os
 import sys
 from datetime import datetime
 from pathlib import Path
+from typing import Optional
 
 
-def setup_logging(log_level: str = "INFO", log_to_file: bool = True, testing: bool = False) -> None:
+def setup_logging(
+    log_level: str = "INFO", 
+    log_to_file: bool = True, 
+    log_to_console: bool = False,  # Changed default to False
+    transport: Optional[str] = None,
+    testing: bool = False
+) -> None:
     """Set up logging configuration.
     
     Args:
         log_level: The logging level ("DEBUG", "INFO", "WARNING", "ERROR", "CRITICAL")
-        log_to_file: Whether to log to a file in addition to the console
+        log_to_file: Whether to log to a file in addition to the console (default: True)
+        log_to_console: Whether to log to the console (default: False to avoid stdio transport conflicts)
+        transport: The transport mechanism being used ("stdio" or "sse")
         testing: Set to True to disable file operations for testing
     """
     # Convert string log level to logging constant
@@ -35,12 +44,14 @@ def setup_logging(log_level: str = "INFO", log_to_file: bool = True, testing: bo
     # Base configuration
     handlers = []
     
-    # Console handler
-    console = logging.StreamHandler(sys.stdout)
-    console.setLevel(numeric_level)
-    console_formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
-    console.setFormatter(console_formatter)
-    handlers.append(console)
+    # Console handler - Always use stderr to avoid interfering with stdio transport
+    # Disable console logging when using stdio transport to avoid protocol corruption
+    if log_to_console and (transport != "stdio"):
+        console = logging.StreamHandler(sys.stderr)
+        console.setLevel(numeric_level)
+        console_formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
+        console.setFormatter(console_formatter)
+        handlers.append(console)
     
     # File handler (if enabled)
     if log_to_file and not testing:
@@ -68,6 +79,8 @@ def setup_logging(log_level: str = "INFO", log_to_file: bool = True, testing: bo
     root_logger.info(f"Logging initialized at level {log_level}")
     if log_to_file and not testing:
         root_logger.info(f"Log file: {log_file}")
+    if not log_to_console or transport == "stdio":
+        root_logger.info("Console logging disabled")
 
 
 def get_log_files() -> list[str]:
@@ -82,3 +95,21 @@ def get_log_files() -> list[str]:
     
     log_files = [str(f) for f in log_dir.glob("hanzo-mcp-*.log")]
     return sorted(log_files, reverse=True)
+
+
+def get_current_log_file() -> Optional[str]:
+    """Get the path to the current log file.
+    
+    Returns:
+        The path to the current log file, or None if no log file exists
+    """
+    log_dir = Path.home() / ".hanzo" / "logs"
+    if not log_dir.exists():
+        return None
+    
+    current_time = datetime.now().strftime("%Y-%m-%d")
+    log_file = log_dir / f"hanzo-mcp-{current_time}.log"
+    
+    if log_file.exists():
+        return str(log_file)
+    return None

{hanzo_mcp-0.3.1 → hanzo_mcp-0.3.4}/hanzo_mcp/tools/shell/command_executor.py

@@ -155,6 +155,9 @@ class CommandExecutor:
         Args:
             message: The message to log
             data: Optional data to include with the message
+
+        Note:
+            Always logs to stderr to avoid interfering with stdio transport
         """
         if not self.verbose:
             return

{hanzo_mcp-0.3.1 → hanzo_mcp-0.3.4}/hanzo_mcp.egg-info/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: hanzo-mcp
-Version: 0.3.1
+Version: 0.3.4
 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
+Project-URL: Documentation, https://github.com/hanzoai/mcp/tree/main/docs
 Keywords: mcp,claude,hanzo,code,agent
 Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: MIT License
@@ -25,6 +25,9 @@ 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"
+Requires-Dist: sphinx>=8.0.0; extra == "dev"
+Requires-Dist: sphinx-rtd-theme>=1.3.0; extra == "dev"
+Requires-Dist: myst-parser>=2.0.0; extra == "dev"
 Provides-Extra: test
 Requires-Dist: pytest>=7.0.0; extra == "test"
 Requires-Dist: pytest-cov>=4.1.0; extra == "test"
@@ -93,7 +96,7 @@ uv pip install hanzo-mcp
 pip install hanzo-mcp
 ```
 
-For detailed installation and configuration instructions, please refer to [INSTALL.md](./doc/INSTALL.md).
+For detailed installation and configuration instructions, please refer to the [documentation](./docs/).
 
 Of course, you can also read [USEFUL_PROMPTS](./doc/USEFUL_PROMPTS.md) for some inspiration on how to use hanzo-mcp.
 
@@ -106,6 +109,20 @@ This implementation follows best practices for securing access to your filesyste
 - Input validation and sanitization
 - Proper error handling and reporting
 
+## Documentation
+
+Comprehensive documentation is available in the [docs](./docs/) directory. You can build and view the documentation locally:
+
+```bash
+# Build the documentation
+make docs
+
+# Start a local server to view the documentation
+make docs-serve
+```
+
+Then open http://localhost:8000/ in your browser to view the documentation.
+
 ## Development
 
 ### Setup Development Environment

{hanzo_mcp-0.3.1 → hanzo_mcp-0.3.4}/hanzo_mcp.egg-info/requires.txt

@@ -10,6 +10,9 @@ pytest>=7.0.0
 pytest-cov>=4.1.0
 ruff>=0.1.0
 black>=23.3.0
+sphinx>=8.0.0
+sphinx-rtd-theme>=1.3.0
+myst-parser>=2.0.0
 
 [performance]
 ujson>=5.7.0

{hanzo_mcp-0.3.1 → hanzo_mcp-0.3.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "hanzo-mcp"
-version = "0.3.1"
+version = "0.3.4"
 description = "MCP implementation of Hanzo capabilities"
 readme = "README.md"
 requires-python = ">=3.12"
@@ -21,10 +21,10 @@ dependencies = ["mcp>=1.6.0", "httpx>=0.27.0", "uvicorn>=0.23.1", "openai>=1.50.
 [project.urls]
 "Homepage" = "https://github.com/hanzoai/mcp"
 "Bug Tracker" = "https://github.com/hanzoai/mcp/issues"
-"Documentation" = "https://github.com/hanzoai/mcp/blob/main/README.md"
+"Documentation" = "https://github.com/hanzoai/mcp/tree/main/docs"
 
 [project.optional-dependencies]
-dev = ["pytest>=7.0.0", "pytest-cov>=4.1.0", "ruff>=0.1.0", "black>=23.3.0"]
+dev = ["pytest>=7.0.0", "pytest-cov>=4.1.0", "ruff>=0.1.0", "black>=23.3.0", "sphinx>=8.0.0", "sphinx-rtd-theme>=1.3.0", "myst-parser>=2.0.0"]
 test = [
   "pytest>=7.0.0",
   "pytest-cov>=4.1.0",