awslabs.finch-mcp-server 0.1.2__tar.gz → 0.1.4__tar.gz

{awslabs_finch_mcp_server-0.1.2 → awslabs_finch_mcp_server-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: awslabs.finch-mcp-server
-Version: 0.1.2
+Version: 0.1.4
 Summary: A Model Context Protocol server for Finch to build and push container images
 Project-URL: Homepage, https://awslabs.github.io/mcp/
 Project-URL: Documentation, https://awslabs.github.io/mcp/servers/finch-mcp-server/
@@ -23,7 +23,7 @@ Classifier: Programming Language :: Python :: 3.13
 Requires-Python: >=3.10
 Requires-Dist: boto3>=1.28.0
 Requires-Dist: loguru>=0.7.0
-Requires-Dist: mcp[cli]>=1.6.0
+Requires-Dist: mcp[cli]>=1.11.0
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: pyyaml>=6.0
 Description-Content-Type: text/markdown
@@ -55,6 +55,10 @@ This MCP server acts as a bridge between MCP clients and Finch, allowing generat
 
 ### Installation
 
+| Cursor | VS Code |
+|:------:|:-------:|
+| [![Install MCP Server](https://cursor.com/deeplink/mcp-install-light.svg)](https://cursor.com/install-mcp?name=awslabs.finch-mcp-server&config=eyJjb21tYW5kIjoidXZ4IGF3c2xhYnMuZmluY2gtbWNwLXNlcnZlckBsYXRlc3QiLCJlbnYiOnsiQVdTX1BST0ZJTEUiOiJkZWZhdWx0IiwiQVdTX1JFR0lPTiI6InVzLXdlc3QtMiIsIkZBU1RNQ1BfTE9HX0xFVkVMIjoiSU5GTyJ9LCJ0cmFuc3BvcnRUeXBlIjoic3RkaW8iLCJkaXNhYmxlZCI6ZmFsc2UsImF1dG9BcHByb3ZlIjpbXX0%3D) | [![Install on VS Code](https://img.shields.io/badge/Install_on-VS_Code-FF9900?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Finch%20MCP%20Server&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22awslabs.finch-mcp-server%40latest%22%5D%2C%22env%22%3A%7B%22AWS_PROFILE%22%3A%22default%22%2C%22AWS_REGION%22%3A%22us-west-2%22%2C%22FASTMCP_LOG_LEVEL%22%3A%22INFO%22%7D%2C%22transportType%22%3A%22stdio%22%2C%22disabled%22%3Afalse%2C%22autoApprove%22%3A%5B%5D%7D) |
+
 Configure the MCP server in your MCP client configuration:
 
 #### Default Mode (Read-only AWS Resources)
@@ -200,12 +204,121 @@ Example:
 - **Error Handling**: Implement proper error handling in your applications when using these tools.
 
 
+## Logging
+
+The Finch MCP server provides comprehensive logging capabilities to help with debugging and monitoring operations.
+
+### Log Destinations
+
+By default, the server logs to two destinations:
+1. **stderr** - Standard error output (follows MCP protocol standards)
+2. **File** - Persistent log file for detailed debugging
+
+### File Logging
+
+#### Default Log Location
+
+Logs are automatically saved to platform-specific directories:
+- **macOS/Linux**: `~/.finch/finch-mcp-server/finch_mcp_server.log`
+- **Windows**: `%LOCALAPPDATA%\finch-mcp-server\finch_mcp_server.log`
+
+#### Custom Log File Location
+
+Specify a custom log file path using the `FINCH_MCP_LOG_FILE` environment variable:
+
+```json
+{
+  "mcpServers": {
+    "awslabs.finch-mcp-server": {
+      "command": "uvx",
+      "args": ["awslabs.finch-mcp-server@latest"],
+      "env": {
+        "FINCH_MCP_LOG_FILE": "~/logs/finch-mcp-server.log"
+      }
+    }
+  }
+}
+```
+
+#### Disable File Logging
+
+To log only to stderr (following strict MCP standards), disable file logging:
+
+```json
+{
+  "mcpServers": {
+    "awslabs.finch-mcp-server": {
+      "command": "uvx",
+      "args": ["awslabs.finch-mcp-server@latest"],
+      "env": {
+        "FINCH_DISABLE_FILE_LOGGING": "true"
+      }
+    }
+  }
+}
+```
+
+Or use the command line argument in the args array:
+```json
+{
+  "mcpServers": {
+    "awslabs.finch-mcp-server": {
+      "command": "uvx",
+      "args": [
+        "awslabs.finch-mcp-server@latest",
+        "--disable-file-logging"
+      ]
+    }
+  }
+}
+```
+
+### Log Features
+
+#### Automatic Log Rotation
+- Log files are automatically rotated when they exceed 10 MB
+- Old logs are compressed (gzip) and retained for 7 days
+- This prevents disk space issues from large log files
+
+#### Sensitive Data Protection
+The logging system automatically redacts sensitive information from log messages:
+- AWS access keys and secret keys
+- API keys, passwords, and tokens
+- JWT tokens and OAuth credentials
+- URLs containing embedded credentials
+
+#### Log Format
+- **stderr**: `{time} | {level} | {message}`
+- **File**: `{time} | {level} | {name}:{function}:{line} | {message}`
+
+The file format includes additional context (function name and line number) for detailed debugging.
+
+### Example Configuration
+
+```json
+{
+  "mcpServers": {
+    "awslabs.finch-mcp-server": {
+      "command": "uvx",
+      "args": ["awslabs.finch-mcp-server@latest"],
+      "env": {
+        "AWS_PROFILE": "default",
+        "AWS_REGION": "us-west-2",
+        "FINCH_MCP_LOG_FILE": "~/logs/finch-mcp-server.log"
+      }
+    }
+  }
+}
+```
+
 ## Troubleshooting
 
 - If you encounter permission errors with ECR, verify your AWS credentials and boto3 configuration are properly set up
 - For Finch VM issues, try running `finch vm stop` and then `finch vm start` manually
 - If the build fails with errors about missing files, check that your context path is correct
 - For general Finch issues, consult the [Finch documentation](https://github.com/runfinch/finch)
+- **Check the logs**: Enable DEBUG level logging and examine the log files for detailed error information
+- **Log file permissions**: If file logging fails, the server will continue with stderr-only logging and show a warning message
 
 ## Version
 

{awslabs_finch_mcp_server-0.1.2 → awslabs_finch_mcp_server-0.1.4}/README.md

@@ -25,6 +25,10 @@ This MCP server acts as a bridge between MCP clients and Finch, allowing generat
 
 ### Installation
 
+| Cursor | VS Code |
+|:------:|:-------:|
+| [![Install MCP Server](https://cursor.com/deeplink/mcp-install-light.svg)](https://cursor.com/install-mcp?name=awslabs.finch-mcp-server&config=eyJjb21tYW5kIjoidXZ4IGF3c2xhYnMuZmluY2gtbWNwLXNlcnZlckBsYXRlc3QiLCJlbnYiOnsiQVdTX1BST0ZJTEUiOiJkZWZhdWx0IiwiQVdTX1JFR0lPTiI6InVzLXdlc3QtMiIsIkZBU1RNQ1BfTE9HX0xFVkVMIjoiSU5GTyJ9LCJ0cmFuc3BvcnRUeXBlIjoic3RkaW8iLCJkaXNhYmxlZCI6ZmFsc2UsImF1dG9BcHByb3ZlIjpbXX0%3D) | [![Install on VS Code](https://img.shields.io/badge/Install_on-VS_Code-FF9900?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Finch%20MCP%20Server&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22awslabs.finch-mcp-server%40latest%22%5D%2C%22env%22%3A%7B%22AWS_PROFILE%22%3A%22default%22%2C%22AWS_REGION%22%3A%22us-west-2%22%2C%22FASTMCP_LOG_LEVEL%22%3A%22INFO%22%7D%2C%22transportType%22%3A%22stdio%22%2C%22disabled%22%3Afalse%2C%22autoApprove%22%3A%5B%5D%7D) |
+
 Configure the MCP server in your MCP client configuration:
 
 #### Default Mode (Read-only AWS Resources)
@@ -170,12 +174,121 @@ Example:
 - **Error Handling**: Implement proper error handling in your applications when using these tools.
 
 
+## Logging
+
+The Finch MCP server provides comprehensive logging capabilities to help with debugging and monitoring operations.
+
+### Log Destinations
+
+By default, the server logs to two destinations:
+1. **stderr** - Standard error output (follows MCP protocol standards)
+2. **File** - Persistent log file for detailed debugging
+
+### File Logging
+
+#### Default Log Location
+
+Logs are automatically saved to platform-specific directories:
+- **macOS/Linux**: `~/.finch/finch-mcp-server/finch_mcp_server.log`
+- **Windows**: `%LOCALAPPDATA%\finch-mcp-server\finch_mcp_server.log`
+
+#### Custom Log File Location
+
+Specify a custom log file path using the `FINCH_MCP_LOG_FILE` environment variable:
+
+```json
+{
+  "mcpServers": {
+    "awslabs.finch-mcp-server": {
+      "command": "uvx",
+      "args": ["awslabs.finch-mcp-server@latest"],
+      "env": {
+        "FINCH_MCP_LOG_FILE": "~/logs/finch-mcp-server.log"
+      }
+    }
+  }
+}
+```
+
+#### Disable File Logging
+
+To log only to stderr (following strict MCP standards), disable file logging:
+
+```json
+{
+  "mcpServers": {
+    "awslabs.finch-mcp-server": {
+      "command": "uvx",
+      "args": ["awslabs.finch-mcp-server@latest"],
+      "env": {
+        "FINCH_DISABLE_FILE_LOGGING": "true"
+      }
+    }
+  }
+}
+```
+
+Or use the command line argument in the args array:
+```json
+{
+  "mcpServers": {
+    "awslabs.finch-mcp-server": {
+      "command": "uvx",
+      "args": [
+        "awslabs.finch-mcp-server@latest",
+        "--disable-file-logging"
+      ]
+    }
+  }
+}
+```
+
+### Log Features
+
+#### Automatic Log Rotation
+- Log files are automatically rotated when they exceed 10 MB
+- Old logs are compressed (gzip) and retained for 7 days
+- This prevents disk space issues from large log files
+
+#### Sensitive Data Protection
+The logging system automatically redacts sensitive information from log messages:
+- AWS access keys and secret keys
+- API keys, passwords, and tokens
+- JWT tokens and OAuth credentials
+- URLs containing embedded credentials
+
+#### Log Format
+- **stderr**: `{time} | {level} | {message}`
+- **File**: `{time} | {level} | {name}:{function}:{line} | {message}`
+
+The file format includes additional context (function name and line number) for detailed debugging.
+
+### Example Configuration
+
+```json
+{
+  "mcpServers": {
+    "awslabs.finch-mcp-server": {
+      "command": "uvx",
+      "args": ["awslabs.finch-mcp-server@latest"],
+      "env": {
+        "AWS_PROFILE": "default",
+        "AWS_REGION": "us-west-2",
+        "FINCH_MCP_LOG_FILE": "~/logs/finch-mcp-server.log"
+      }
+    }
+  }
+}
+```
+
 ## Troubleshooting
 
 - If you encounter permission errors with ECR, verify your AWS credentials and boto3 configuration are properly set up
 - For Finch VM issues, try running `finch vm stop` and then `finch vm start` manually
 - If the build fails with errors about missing files, check that your context path is correct
 - For general Finch issues, consult the [Finch documentation](https://github.com/runfinch/finch)
+- **Check the logs**: Enable DEBUG level logging and examine the log files for detailed error information
+- **Log file permissions**: If file logging fails, the server will continue with stderr-only logging and show a warning message
 
 ## Version
 

{awslabs_finch_mcp_server-0.1.2 → awslabs_finch_mcp_server-0.1.4}/awslabs/finch_mcp_server/__init__.py

@@ -14,4 +14,4 @@
 
 """awslabs.finch-mcp-server"""
 
-__version__ = '0.1.0'
+__version__ = '0.1.4'

{awslabs_finch_mcp_server-0.1.2 → awslabs_finch_mcp_server-0.1.4}/awslabs/finch_mcp_server/consts.py

@@ -24,8 +24,6 @@ import sys
 # Server name
 SERVER_NAME = 'finch_mcp_server'
 
-# Log file name
-LOG_FILE = 'finch_server.log'
 
 # VM states
 VM_STATE_RUNNING = 'running'

{awslabs_finch_mcp_server-0.1.2 → awslabs_finch_mcp_server-0.1.4}/awslabs/finch_mcp_server/server.py

@@ -23,7 +23,7 @@ purposes only and are not meant for production use cases.
 import os
 import re
 import sys
-from awslabs.finch_mcp_server.consts import LOG_FILE, SERVER_NAME
+from awslabs.finch_mcp_server.consts import SERVER_NAME
 
 # Import Pydantic models for input validation
 from awslabs.finch_mcp_server.models import Result
@@ -46,11 +46,97 @@ from awslabs.finch_mcp_server.utils.vm import (
 )
 from loguru import logger
 from mcp.server.fastmcp import FastMCP
+from pathlib import Path
 from pydantic import Field
 from typing import Any, Dict, List, Optional
 
 
-# Configure loguru logger
+def get_default_log_path():
+    """Get platform-appropriate persistent log directory."""
+    if os.name == 'nt':  # Windows
+        app_data = os.environ.get('LOCALAPPDATA')
+        if not app_data:
+            return None  # No suitable location found
+        log_dir = os.path.join(app_data, 'finch-mcp-server')
+    else:  # Unix/Linux/macOS
+        # Use ~/.finch/finch-mcp-server/ for persistent logs
+        if 'HOME' in os.environ:
+            log_dir = os.path.join(Path.home(), '.finch', 'finch-mcp-server')
+        else:
+            return None  # No suitable location found
+
+    # Create directory if it doesn't exist (including parent directories)
+    try:
+        os.makedirs(log_dir, exist_ok=True)
+        log_file_path = os.path.join(log_dir, 'finch_mcp_server.log')
+        return log_file_path
+    except (OSError, PermissionError):
+        # Return None if we can't create the directory
+        return None
+
+
+def configure_logging(server_name: str = 'finch-mcp-server'):
+    """Configure logging based on environment variables and command line arguments.
+
+    Args:
+        server_name: Name to bind to the logger for identification
+
+    Returns:
+        The configured logger instance
+
+    """
+    logger.remove()
+
+    # Configure logging destinations
+    log_level = os.environ.get('FASTMCP_LOG_LEVEL', 'INFO')
+    file_logging_disabled = os.environ.get('FINCH_DISABLE_FILE_LOGGING', '').lower() in (
+        'true',
+        '1',
+        'yes',
+    )
+    custom_log_file = os.environ.get('FINCH_MCP_LOG_FILE')  # User-specified log file location
+
+    # Always log to stderr (MCP standard)
+    logger.add(
+        sys.stderr,
+        level=log_level,
+        format='{time:YYYY-MM-DD HH:mm:ss} | {level} | {message}',
+        filter=sensitive_data_filter,
+    )
+
+    # File logging (default to app data directory unless disabled or custom location specified)
+    if not file_logging_disabled:
+        log_file = custom_log_file or get_default_log_path()
+
+        if log_file:
+            try:
+                logger.add(
+                    log_file,
+                    level=log_level,
+                    format='{time:YYYY-MM-DD HH:mm:ss} | {level} | {name}:{function}:{line} | {message}',
+                    filter=sensitive_data_filter,
+                    rotation='10 MB',
+                    retention='7 days',
+                    compression='gz',
+                )
+                # Log initialization message to ensure file gets created
+                logger.info('File logging initialized successfully')
+            except (OSError, PermissionError) as e:
+                # If we can't write to the log file, warn but continue with stderr only
+                logger.warning(
+                    f'Could not create log file at {log_file}: {e}. Logging to stderr only.'
+                )
+        else:
+            # No suitable location found for log file
+            logger.warning(
+                'Could not find suitable location for log file. Logging to stderr only.'
+            )
+
+    # Re-bind logger with server name
+    bound_logger = logger.bind(name=server_name)
+    return bound_logger
+
+
 def sensitive_data_filter(record):
     """Filter that redacts sensitive information from log messages.
 
@@ -133,27 +219,9 @@ def sensitive_data_filter(record):
     return True
 
 
-# Remove all default handlers then add our own
+# Initialize basic stderr-only logging until we parse arguments
 logger.remove()
-
-log_level = os.environ.get('FASTMCP_LOG_LEVEL', 'INFO').upper()
-logger.add(
-    LOG_FILE,
-    rotation='10 MB',
-    retention=7,
-    level=log_level,
-    format='{time:YYYY-MM-DD HH:mm:ss} | {level} | {name}:{function}:{line} | {message}',
-    filter=sensitive_data_filter,
-)
-
-# Add a handler for stderr
-logger.add(
-    sys.stderr,
-    level=log_level,
-    format='{time:YYYY-MM-DD HH:mm:ss} | {level} | {message}',
-    filter=sensitive_data_filter,
-)
-
+logger.add(sys.stderr, level='INFO', filter=sensitive_data_filter)
 logger = logger.bind(name=SERVER_NAME)
 
 # Initialize the MCP server
@@ -438,11 +506,20 @@ def main(enable_aws_resource_write: bool = False):
     set_enable_aws_resource_write(enable_aws_resource_write)
 
     logger.info('Starting Finch MCP server')
-    logger.info(f'Logs will be written to: {LOG_FILE}')
+
+    # Log where logs are going
+    log_file = os.environ.get('FINCH_MCP_LOG_FILE')
+    if log_file:
+        logger.info(f'Logging to stderr and file: {log_file}')
+    elif os.environ.get('FINCH_DISABLE_FILE_LOGGING'):
+        logger.warning('Logging to stderr only')
+    else:
+        logger.info('Logging to stderr and default logging file')
+
     mcp.run(transport='stdio')
 
 
-if __name__ == '__main__':
+if __name__ == '__main__':  # pragma: no cover
     import argparse
 
     parser = argparse.ArgumentParser(description='Run the Finch MCP server')
@@ -451,6 +528,18 @@ if __name__ == '__main__':
         action='store_true',
         help='Enable AWS resource creation and modification (disabled by default)',
     )
+    parser.add_argument(
+        '--disable-file-logging',
+        action='store_true',
+        help='Disable file logging entirely (stderr only, follows MCP standard)',
+    )
     args = parser.parse_args()
 
+    # Set disable file logging from command line if provided
+    if args.disable_file_logging:
+        os.environ['FINCH_DISABLE_FILE_LOGGING'] = 'true'
+
+    # Configure logging after parsing arguments
+    configure_logging()
+
     main(enable_aws_resource_write=args.enable_aws_resource_write)

{awslabs_finch_mcp_server-0.1.2 → awslabs_finch_mcp_server-0.1.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "awslabs.finch-mcp-server"
-version = "0.1.2"
+version = "0.1.4"
 description = "A Model Context Protocol server for Finch to build and push container images"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -20,7 +20,7 @@ classifiers = [
     "Programming Language :: Python :: 3.13",
 ]
 dependencies = [
-    "mcp[cli]>=1.6.0",
+    "mcp[cli]>=1.11.0",
     "pydantic>=2.0.0",
     "boto3>=1.28.0",
     "loguru>=0.7.0",