Add generate_claude_desktop_config.py for Claude Desktop integration

- Introduce a new script to generate configuration for Claude Desktop based on Basecamp MCP integration. - Update README with setup instructions for Claude Desktop users, including configuration generation steps and troubleshooting tips. - Ensure compatibility with both Cursor and Claude Desktop clients.
2025-07-27 20:18:03 +01:00
parent 1cb7b4423b
commit ee3f31fcd2
2 changed files with 228 additions and 9 deletions
--- a/generate_claude_desktop_config.py
+++ b/generate_claude_desktop_config.py
@@ -0,0 +1,137 @@
+#!/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()