hanzo-mcp 0.3.1__py3-none-any.whl → 0.3.3__py3-none-any.whl

hanzo_mcp/__init__.py

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

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/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/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.dist-info → hanzo_mcp-0.3.3.dist-info}/METADATA

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: hanzo-mcp
-Version: 0.3.1
+Version: 0.3.3
 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.dist-info → hanzo_mcp-0.3.3.dist-info}/RECORD

@@ -1,5 +1,5 @@
-hanzo_mcp/__init__.py,sha256=roRFuV1ugS6Zf28PtFGKzOnpJMDFncOz6fR3TlG-LF0,89
-hanzo_mcp/cli.py,sha256=ST428ys32fputErgrmLNJV9oYHbKGwkjrPBJfKh_K_Y,10820
+hanzo_mcp/__init__.py,sha256=TGjXG3-jW-pduEg0z6QzesvTiXw58D44bYgp8m_9qdc,89
+hanzo_mcp/cli.py,sha256=Z_N1ziVdFmgl8SDEG4Dce07brbNzdx3nUR7KgAVcoY8,12557
 hanzo_mcp/server.py,sha256=bV4ywWOgm7BwZrbZwv1qoRKbAsMYT08aCGQwuFS8raM,6678
 hanzo_mcp/tools/__init__.py,sha256=9LbWAPfSntDwLaAex3dagsHO4BgZQHKj5E6UX-Gmyb4,3496
 hanzo_mcp/tools/agent/__init__.py,sha256=0eyQqqdAy7WCZEqUfV6xh66bDpQI9neB6iDjWf0_pJI,2189
@@ -15,7 +15,7 @@ hanzo_mcp/tools/common/__init__.py,sha256=felrGAEqLWOa8fuHjTCS7khqtlA-izz8k865ky
 hanzo_mcp/tools/common/base.py,sha256=O7Lgft0XiC9Iyi3fYsmoWWrvKDK2Aa-FJLxPgnNJRJY,7341
 hanzo_mcp/tools/common/context.py,sha256=ReIfcm37j5qnLQ8G_-d88ad5uC1OKkjQZKG9HdJPybI,13145
 hanzo_mcp/tools/common/error_handling.py,sha256=rluaHpXV89pjcf8JxgYB6EdqVkcxihb3pyEO2gN-u7w,2789
-hanzo_mcp/tools/common/logging_config.py,sha256=b1swgWV3nuhpVT0TCcbxlOC0gmiRLmbey_t2LOWEMbU,2793
+hanzo_mcp/tools/common/logging_config.py,sha256=664VEaV671t3_PG9qPMf_twVCQYendeQAqm-NuS32dU,3931
 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/think_tool.py,sha256=I-O6ipM-PUofkNoMMzv37Y_2Yfx9mh7F1upTTsfRN4M,4046
@@ -41,13 +41,13 @@ hanzo_mcp/tools/project/base.py,sha256=CniLAsjum5vC3cgvF9AqU-_ZY_0Nf9uaF2L_xV2ob
 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/command_executor.py,sha256=sNQEiU0qGVJQuq8HqMFD5h1N3CmOfSuoHj5UMpSnaBY,32707
 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.3.1.dist-info/licenses/LICENSE,sha256=mf1qZGFsPGskoPgytp9B-RsahfKvXsBpmaAbTLGTt8Y,1063
-hanzo_mcp-0.3.1.dist-info/METADATA,sha256=ay2jJEkPi-ivKlvoCRyCNj57-M0tT36tL4w5nuK_SQ0,7550
-hanzo_mcp-0.3.1.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
-hanzo_mcp-0.3.1.dist-info/entry_points.txt,sha256=aRKOKXtuQr-idSr-yH4efnRl2v8te94AcgN3ysqqSYs,49
-hanzo_mcp-0.3.1.dist-info/top_level.txt,sha256=eGFANatA0MHWiVlpS56fTYRIShtibrSom1uXI6XU0GU,10
-hanzo_mcp-0.3.1.dist-info/RECORD,,
+hanzo_mcp-0.3.3.dist-info/licenses/LICENSE,sha256=mf1qZGFsPGskoPgytp9B-RsahfKvXsBpmaAbTLGTt8Y,1063
+hanzo_mcp-0.3.3.dist-info/METADATA,sha256=OyTlavBJpC_-79IRKfQo5aaHYsV2q9OMSsbO7kEcHS4,8029
+hanzo_mcp-0.3.3.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
+hanzo_mcp-0.3.3.dist-info/entry_points.txt,sha256=aRKOKXtuQr-idSr-yH4efnRl2v8te94AcgN3ysqqSYs,49
+hanzo_mcp-0.3.3.dist-info/top_level.txt,sha256=eGFANatA0MHWiVlpS56fTYRIShtibrSom1uXI6XU0GU,10
+hanzo_mcp-0.3.3.dist-info/RECORD,,