basecamp-mcp-server/generate_claude_desktop_config.py

#!/usr/bin/env python3
"""
Generate Claude Desktop configuration for Basecamp MCP Integration.
Based on official MCP quickstart guide: https://modelcontextprotocol.io/quickstart/server
"""

import os
import sys
import json
import platform
from pathlib import Path
from dotenv import load_dotenv

def get_project_root():
    """Get the absolute path to the project root."""
    return os.path.abspath(os.path.dirname(__file__))

def get_python_path():
    """Get the Python executable path from virtual environment."""
    project_root = get_project_root()
    
    if platform.system() == "Windows":
        python_path = os.path.join(project_root, "venv", "Scripts", "python.exe")
    else:
        python_path = os.path.join(project_root, "venv", "bin", "python")
    
    # Convert to absolute path
    return os.path.abspath(python_path)

def get_claude_desktop_config_path():
    """Get the Claude Desktop configuration file path."""
    if platform.system() == "Windows":
        return os.path.expanduser("~/AppData/Roaming/Claude/claude_desktop_config.json")
    elif platform.system() == "Darwin":  # macOS
        return os.path.expanduser("~/Library/Application Support/Claude/claude_desktop_config.json")
    else:  # Linux
        return os.path.expanduser("~/.config/claude-desktop/claude_desktop_config.json")

def generate_config():
    """Generate the Claude Desktop configuration for Basecamp MCP server."""
    project_root = get_project_root()
    python_path = get_python_path()
    script_path = os.path.join(project_root, "basecamp_fastmcp.py")
    
    # Load .env file to get BASECAMP_ACCOUNT_ID
    dotenv_path = os.path.join(project_root, ".env")
    load_dotenv(dotenv_path)
    basecamp_account_id = os.getenv("BASECAMP_ACCOUNT_ID")
    
    if not basecamp_account_id:
        print("⚠️  Warning: BASECAMP_ACCOUNT_ID not found in .env file")
        print("   Add BASECAMP_ACCOUNT_ID to your .env file for proper configuration")
        basecamp_account_id = "YOUR_ACCOUNT_ID_HERE"
    
    # Verify Python executable exists
    if not os.path.exists(python_path):
        print(f"❌ Python executable not found at {python_path}")
        print("   Run 'python setup.py' first to create the virtual environment")
        return False
    
    # Verify FastMCP server exists
    if not os.path.exists(script_path):
        print(f"❌ FastMCP server not found at {script_path}")
        return False
    
    # Create configuration
    config = {
        "mcpServers": {
            "basecamp": {
                "command": python_path,
                "args": [script_path],
                "env": {
                    "PYTHONPATH": project_root,
                    "VIRTUAL_ENV": os.path.join(project_root, "venv"),
                    "BASECAMP_ACCOUNT_ID": basecamp_account_id
                }
            }
        }
    }
    
    config_path = get_claude_desktop_config_path()
    config_dir = os.path.dirname(config_path)
    
    # Create config directory if it doesn't exist
    os.makedirs(config_dir, exist_ok=True)
    
    # Load existing config if it exists
    existing_config = {}
    if os.path.exists(config_path):
        try:
            with open(config_path, 'r') as f:
                existing_config = json.load(f)
        except json.JSONDecodeError:
            print(f"⚠️  Warning: Existing config at {config_path} has invalid JSON")
            existing_config = {}
    
    # Merge with existing mcpServers
    if "mcpServers" not in existing_config:
        existing_config["mcpServers"] = {}
    
    # Add or update Basecamp server
    existing_config["mcpServers"]["basecamp"] = config["mcpServers"]["basecamp"]
    
    # Write configuration
    try:
        with open(config_path, 'w') as f:
            json.dump(existing_config, f, indent=2)
        
        print("✅ Claude Desktop configuration updated successfully!")
        print(f"📍 Config file: {config_path}")
        print("\n📋 Configuration details:")
        print(f"   • Server name: basecamp")
        print(f"   • Python path: {python_path}")
        print(f"   • Server script: {script_path}")
        print(f"   • Account ID: {basecamp_account_id}")
        print("\n🔄 Next steps:")
        print("   1. Restart Claude Desktop completely")
        print("   2. Look for the MCP tools icon in Claude Desktop")
        print("   3. Enable Basecamp tools in your conversation")
        print("\n💡 Tip: Check ~/Library/Logs/Claude/mcp*.log for troubleshooting")
        
        return True
        
    except Exception as e:
        print(f"❌ Error writing configuration: {str(e)}")
        return False

def main():
    """Main function."""
    print("🚀 Generating Claude Desktop Configuration for Basecamp MCP")
    print("=" * 60)
    
    if not generate_config():
        sys.exit(1)

if __name__ == "__main__":
    main()