devsync 0.5.5__py3-none-any.whl

aiconfigkit/cli/mcp_install.py

@@ -0,0 +1,166 @@
+"""CLI command for installing MCP templates."""
+
+import logging
+from pathlib import Path
+
+import typer
+from rich.console import Console
+from rich.progress import Progress, SpinnerColumn, TextColumn
+
+from aiconfigkit.core.mcp.manager import MCPManager
+from aiconfigkit.core.models import InstallationScope
+
+logger = logging.getLogger(__name__)
+console = Console()
+
+
+def mcp_install_command(
+    source: str = typer.Argument(..., help="Source URL or local path to MCP template repository"),
+    namespace: str = typer.Option(..., "--as", help="Namespace for this template (unique identifier)"),
+    scope: str = typer.Option("project", "--scope", help="Installation scope: project or global"),
+    force: bool = typer.Option(False, "--force", help="Overwrite existing template if it exists"),
+    json_output: bool = typer.Option(False, "--json", help="Output results as JSON"),
+) -> int:
+    """
+    Install MCP server configurations from a template repository.
+
+    This downloads and caches MCP server definitions from a Git repository or local
+    directory into your local library. After installation, use 'inskit mcp configure'
+    to set up credentials and 'inskit mcp sync' to apply to AI tools.
+
+    Examples:
+
+        # Install from GitHub repository
+        inskit mcp install https://github.com/company/backend-tools --as backend
+
+        # Install from local directory
+        inskit mcp install ./my-mcp-configs --as local-tools
+
+        # Install globally (available in all projects)
+        inskit mcp install https://github.com/me/personal-tools --as personal --scope global
+
+        # Force overwrite existing template
+        inskit mcp install https://github.com/company/backend-tools --as backend --force
+    """
+    try:
+        # Parse scope
+        try:
+            install_scope = InstallationScope(scope)
+        except ValueError:
+            console.print(f"[red]Error:[/red] Invalid scope '{scope}'. Must be 'project' or 'global'")
+            return 1
+
+        # Get library root
+        library_root = _get_library_root()
+
+        # Create MCP manager
+        manager = MCPManager(library_root)
+
+        # Install template with progress indicator
+        with Progress(
+            SpinnerColumn(),
+            TextColumn("[progress.description]{task.description}"),
+            console=console,
+        ) as progress:
+            task = progress.add_task(f"Installing MCP template '{namespace}'...", total=None)
+
+            try:
+                template = manager.install_template(
+                    source=source,
+                    namespace=namespace,
+                    scope=install_scope,
+                    force=force,
+                )
+            finally:
+                progress.remove_task(task)
+
+        # Output results
+        if json_output:
+            import json
+
+            result = {
+                "success": True,
+                "namespace": template.namespace,
+                "version": template.version,
+                "servers": len(template.servers),
+                "sets": len(template.sets),
+                "scope": install_scope.value,
+            }
+            console.print(json.dumps(result, indent=2))
+        else:
+            console.print(f"[green]✓[/green] Installed MCP template: [bold]{namespace}[/bold]")
+            console.print(f"  Version: {template.version}")
+            console.print(f"  Description: {template.description}")
+            console.print(f"  Servers: {len(template.servers)}")
+            console.print(f"  Sets: {len(template.sets)}")
+            console.print(f"  Scope: {install_scope.value}")
+
+            # Show next steps
+            console.print("\n[bold]Next steps:[/bold]")
+
+            # Check which servers need configuration
+            servers_needing_config = [s for s in template.servers if s.get_required_env_vars()]
+
+            if servers_needing_config:
+                console.print("  1. Configure credentials for servers:")
+                for server in servers_needing_config[:3]:  # Show first 3
+                    console.print(f"     [cyan]inskit mcp configure {namespace}.{server.name}[/cyan]")
+                if len(servers_needing_config) > 3:
+                    console.print(f"     ... and {len(servers_needing_config) - 3} more")
+            else:
+                console.print("  1. [dim]No credentials needed for servers[/dim]")
+
+            console.print("  2. Sync to AI tools: [cyan]inskit mcp sync --tool all[/cyan]")
+
+            if template.sets:
+                set_name = template.sets[0].name
+                console.print(f"  3. Or activate a set: [cyan]inskit mcp activate {namespace}.{set_name}[/cyan]")
+
+        return 0
+
+    except ValueError as e:
+        if json_output:
+            import json
+
+            console.print(json.dumps({"success": False, "error": str(e)}, indent=2))
+        else:
+            console.print(f"[red]Error:[/red] {e}")
+        return 1
+
+    except FileNotFoundError as e:
+        if json_output:
+            import json
+
+            console.print(json.dumps({"success": False, "error": str(e)}, indent=2))
+        else:
+            console.print(f"[red]Error:[/red] {e}")
+        return 1
+
+    except RuntimeError as e:
+        if json_output:
+            import json
+
+            console.print(json.dumps({"success": False, "error": str(e)}, indent=2))
+        else:
+            console.print(f"[red]Error:[/red] {e}")
+        return 1
+
+    except Exception as e:
+        logger.exception("Unexpected error during MCP template installation")
+        if json_output:
+            import json
+
+            console.print(json.dumps({"success": False, "error": f"Unexpected error: {e}"}, indent=2))
+        else:
+            console.print(f"[red]Unexpected error:[/red] {e}")
+        return 1
+
+
+def _get_library_root() -> Path:
+    """
+    Get the library root directory.
+
+    Returns:
+        Path to library root (~/.instructionkit/library/)
+    """
+    return Path.home() / ".instructionkit" / "library"

aiconfigkit/cli/mcp_sync.py

@@ -0,0 +1,165 @@
+"""CLI command for syncing MCP servers to AI tools."""
+
+import logging
+from pathlib import Path
+
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from aiconfigkit.ai_tools.mcp_syncer import MCPSyncer
+from aiconfigkit.core.models import InstallationScope
+
+logger = logging.getLogger(__name__)
+console = Console()
+
+
+def mcp_sync_command(
+    tool: str = typer.Option(
+        "all",
+        "--tool",
+        "-t",
+        help="AI tool to sync to (claude, cursor, windsurf, or all)",
+    ),
+    scope: str = typer.Option(
+        "project",
+        "--scope",
+        help="Scope to load configurations from (project or global)",
+    ),
+    dry_run: bool = typer.Option(
+        False,
+        "--dry-run",
+        help="Show what would be synced without actually syncing",
+    ),
+    no_backup: bool = typer.Option(
+        False,
+        "--no-backup",
+        help="Skip creating backup of config files before modifying",
+    ),
+    json_output: bool = typer.Option(
+        False,
+        "--json",
+        help="Output results as JSON",
+    ),
+) -> int:
+    """
+    Sync configured MCP servers to AI tool configuration files.
+
+    This command reads installed MCP servers from the library, resolves their
+    environment variables from .instructionkit/.env, and writes them to AI
+    tool configuration files (e.g., claude_desktop_config.json).
+
+    Examples:
+
+        # Sync to all detected AI tools
+        inskit mcp sync --tool all
+
+        # Sync to specific tool
+        inskit mcp sync --tool claude
+
+        # Dry run to see what would be synced
+        inskit mcp sync --tool all --dry-run
+
+        # Sync without creating backups
+        inskit mcp sync --tool claude --no-backup
+
+        # Sync global configurations
+        inskit mcp sync --scope global
+    """
+    try:
+        # Parse scope
+        try:
+            install_scope = InstallationScope(scope)
+        except ValueError:
+            console.print(f"[red]Error:[/red] Invalid scope '{scope}'. Must be 'project' or 'global'")
+            return 1
+
+        # Create syncer
+        syncer = MCPSyncer(
+            library_root=Path.home() / ".instructionkit" / "library",
+            project_root=Path.cwd(),
+        )
+
+        # Parse tool names
+        tool_names = [tool] if tool != "all" else ["all"]
+
+        # Show sync info
+        if not json_output:
+            console.print("\n[bold]Syncing MCP servers to AI tools[/bold]")
+            console.print(f"Scope: {install_scope.value}")
+            console.print(f"Tools: {tool}")
+            if dry_run:
+                console.print("[yellow]DRY RUN - no changes will be made[/yellow]")
+            console.print()
+
+        # Perform sync
+        result = syncer.sync_all(
+            tool_names=tool_names,
+            scope=install_scope,
+            create_backup=not no_backup,
+            dry_run=dry_run,
+        )
+
+        # Output results
+        if json_output:
+            import json
+
+            output = {
+                "success": result.success,
+                "synced_tools": result.synced_tools,
+                "skipped_tools": [{"name": name, "reason": reason} for name, reason in result.skipped_tools],
+                "synced_servers": result.synced_servers,
+                "skipped_servers": [{"name": name, "reason": reason} for name, reason in result.skipped_servers],
+            }
+            console.print(json.dumps(output, indent=2))
+        else:
+            # Show synced tools
+            if result.synced_tools:
+                console.print(f"[green]✓[/green] Synced to {len(result.synced_tools)} tool(s):")
+                for tool_name in result.synced_tools:
+                    console.print(f"  • {tool_name}")
+            else:
+                console.print("[yellow]⚠[/yellow] No tools were synced")
+
+            # Show skipped tools
+            if result.skipped_tools:
+                console.print(f"\n[yellow]⚠[/yellow] Skipped {len(result.skipped_tools)} tool(s):")
+                for tool_name, reason in result.skipped_tools:
+                    console.print(f"  • {tool_name}: {reason}")
+
+            # Show server summary
+            console.print("\n[bold]Server Summary:[/bold]")
+            console.print(f"  Synced: {len(result.synced_servers)} server(s)")
+            if result.skipped_servers:
+                console.print(f"  Skipped: {len(result.skipped_servers)} server(s)")
+
+            # Show skipped servers details
+            if result.skipped_servers:
+                console.print("\n[yellow]Skipped Servers:[/yellow]")
+                table = Table(show_header=True)
+                table.add_column("Server", style="cyan")
+                table.add_column("Reason", style="yellow")
+
+                for server_name, reason in result.skipped_servers:
+                    table.add_row(server_name, reason)
+
+                console.print(table)
+
+                console.print(
+                    "\n[dim]Tip: Run 'inskit mcp configure <namespace>' to configure missing credentials[/dim]"
+                )
+
+        if not result.success:
+            return 1
+
+        return 0
+
+    except Exception as e:
+        logger.exception("Unexpected error during MCP sync")
+        if json_output:
+            import json
+
+            console.print(json.dumps({"success": False, "error": str(e)}, indent=2))
+        else:
+            console.print(f"[red]Unexpected error:[/red] {e}")
+        return 1