qbraid-cli 0.10.9a1__py3-none-any.whl → 0.11.0__py3-none-any.whl

qbraid_cli/configure/app.py

@@ -131,5 +131,92 @@ def configure_magic():
     console.print(f"\n\t{in_1}\n\n\t{in_2}\n")
 
 
+@configure_app.command(name="claude")
+def configure_claude(
+    action: str = typer.Argument(
+        ...,
+        help="Action to perform: 'add', 'remove', or 'show'",
+    ),
+    overwrite: bool = typer.Option(
+        False,
+        "--overwrite",
+        help="Overwrite existing MCP server configuration",
+    ),
+):
+    """
+    Manage qBraid MCP server in Claude Desktop configuration.
+
+    Add, remove, or show the qBraid MCP server in your Claude Desktop config
+    (claude_desktop_config.json).
+    """
+    # pylint: disable-next=import-outside-toplevel
+    from qbraid_cli.configure.claude_config import (
+        add_qbraid_mcp_server,
+        get_claude_config_path,
+        get_qbraid_mcp_server_config,
+        remove_qbraid_mcp_server,
+    )
+
+    console = Console()
+
+    # Validate action
+    valid_actions = ["add", "remove", "show"]
+    if action not in valid_actions:
+        console.print(
+            f"[red]Error:[/red] Invalid action '{action}'. "
+            f"Must be one of: {', '.join(valid_actions)}"
+        )
+        raise typer.Exit(1)
+
+    # Check if Claude config exists (except for show which can work without it)
+    if action != "show":
+        config_path = get_claude_config_path()
+        if config_path is None:
+            console.print(
+                "[yellow]Warning:[/yellow] Claude Desktop config file not found.\n"
+                "Expected locations:\n"
+                "  - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json\n"
+                "  - Windows: %APPDATA%\\Claude\\claude_desktop_config.json\n"
+                "  - Linux: ~/.config/Claude/claude_desktop_config.json\n\n"
+                "Creating new config file..."
+            )
+
+    # Perform action
+    if action == "add":
+        success, message = add_qbraid_mcp_server(overwrite=overwrite)
+        if success:
+            console.print(f"[green]Success:[/green] {message}")
+            console.print(
+                "\n[yellow]Note:[/yellow] You may need to restart Claude Desktop "
+                "for changes to take effect."
+            )
+        else:
+            console.print(f"[red]Error:[/red] {message}")
+            raise typer.Exit(1)
+
+    elif action == "remove":
+        success, message = remove_qbraid_mcp_server()
+        if success:
+            console.print(f"[green]Success:[/green] {message}")
+            console.print(
+                "\n[yellow]Note:[/yellow] You may need to restart Claude Desktop "
+                "for changes to take effect."
+            )
+        else:
+            console.print(f"[red]Error:[/red] {message}")
+            raise typer.Exit(1)
+
+    elif action == "show":
+        server_config = get_qbraid_mcp_server_config()
+        if server_config is None:
+            console.print("No qBraid MCP server found in Claude Desktop configuration.")
+            return
+
+        console.print("\n[cyan]qBraid MCP Server Configuration:[/cyan]\n")
+        console.print(f"  Command: {server_config.get('command', 'N/A')}")
+        console.print(f"  Args: {server_config.get('args', [])}")
+        console.print()
+
+
 if __name__ == "__main__":
     configure_app()

qbraid_cli/configure/claude_config.py

@@ -0,0 +1,215 @@
+# Copyright (c) 2025, qBraid Development Team
+# All rights reserved.
+
+"""
+Utility functions for managing Claude Desktop configuration.
+
+This module provides cross-platform support for locating and updating
+the claude_desktop_config.json file used by Claude Desktop.
+"""
+
+import json
+import os
+import platform
+import shutil
+from pathlib import Path
+from typing import Optional
+
+
+def get_claude_config_path() -> Optional[Path]:
+    """
+    Get the path to the Claude Desktop configuration file.
+
+    Returns the platform-specific path to claude_desktop_config.json:
+    - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
+    - Windows: %APPDATA%\\Claude\\claude_desktop_config.json
+    - Linux: ~/.config/Claude/claude_desktop_config.json
+
+    Returns:
+        Path to the config file if it exists, None otherwise
+    """
+    system = platform.system()
+
+    if system == "Darwin":  # macOS
+        config_path = Path.home() / "Library" / "Application Support" / "Claude"
+    elif system == "Windows":
+        appdata = os.environ.get("APPDATA")
+        if not appdata:
+            return None
+        config_path = Path(appdata) / "Claude"
+    elif system == "Linux":
+        config_path = Path.home() / ".config" / "Claude"
+    else:
+        return None
+
+    config_file = config_path / "claude_desktop_config.json"
+    return config_file if config_file.exists() else None
+
+
+def load_claude_config() -> dict:
+    """
+    Load the Claude Desktop configuration file.
+
+    Returns:
+        Configuration dictionary. If file doesn't exist, returns empty dict.
+
+    Raises:
+        json.JSONDecodeError: If config file exists but contains invalid JSON
+        OSError: If there are permission issues reading the file
+    """
+    config_path = get_claude_config_path()
+
+    if config_path is None or not config_path.exists():
+        return {}
+
+    with open(config_path, "r", encoding="utf-8") as f:
+        return json.load(f)
+
+
+def save_claude_config(config: dict) -> Path:
+    """
+    Save the Claude Desktop configuration file.
+
+    Creates the configuration directory if it doesn't exist.
+
+    Args:
+        config: Configuration dictionary to save
+
+    Returns:
+        Path to the saved configuration file
+
+    Raises:
+        OSError: If there are permission issues or the platform is unsupported
+    """
+    system = platform.system()
+
+    if system == "Darwin":  # macOS
+        config_dir = Path.home() / "Library" / "Application Support" / "Claude"
+    elif system == "Windows":
+        appdata = os.environ.get("APPDATA")
+        if not appdata:
+            raise OSError("APPDATA environment variable not set")
+        config_dir = Path(appdata) / "Claude"
+    elif system == "Linux":
+        config_dir = Path.home() / ".config" / "Claude"
+    else:
+        raise OSError(f"Unsupported platform: {system}")
+
+    # Create directory if it doesn't exist
+    config_dir.mkdir(parents=True, exist_ok=True)
+
+    config_file = config_dir / "claude_desktop_config.json"
+
+    # Write config with pretty formatting
+    with open(config_file, "w", encoding="utf-8") as f:
+        json.dump(config, f, indent=2, ensure_ascii=False)
+        f.write("\n")  # Add trailing newline
+
+    return config_file
+
+
+def add_qbraid_mcp_server(overwrite: bool = False) -> tuple[bool, str]:
+    """
+    Add qBraid MCP server configuration to Claude Desktop config.
+
+    Args:
+        overwrite: If True, overwrite existing qbraid entry
+
+    Returns:
+        Tuple of (success: bool, message: str)
+    """
+    # Get the full path to qbraid executable
+    qbraid_path = shutil.which("qbraid")
+    if not qbraid_path:
+        return (
+            False,
+            "Could not find qbraid executable in PATH. "
+            "Please ensure qbraid-cli is installed and accessible.",
+        )
+
+    try:
+        config = load_claude_config()
+    except json.JSONDecodeError as e:
+        return False, f"Invalid JSON in Claude config file: {e}"
+    except OSError as e:
+        return False, f"Error reading Claude config file: {e}"
+
+    # Initialize mcpServers section if it doesn't exist
+    if "mcpServers" not in config:
+        config["mcpServers"] = {}
+
+    # Determine server name
+    server_name = "qbraid"
+
+    # Check if server already exists
+    if server_name in config["mcpServers"] and not overwrite:
+        return (
+            False,
+            f"MCP server '{server_name}' already exists in config. "
+            "Use --overwrite to replace it.",
+        )
+
+    # Build server configuration with full path to qbraid
+    server_config = {"command": qbraid_path, "args": ["mcp", "serve"]}
+
+    # Add server to config
+    config["mcpServers"][server_name] = server_config
+
+    # Save config
+    try:
+        config_path = save_claude_config(config)
+        action = "Updated" if server_name in config["mcpServers"] else "Added"
+        return True, f"{action} MCP server '{server_name}' in [cyan]{config_path}[/cyan]"
+    except OSError as e:
+        return False, f"Error saving Claude config file: {e}"
+
+
+def remove_qbraid_mcp_server() -> tuple[bool, str]:
+    """
+    Remove qBraid MCP server configuration from Claude Desktop config.
+
+    Returns:
+        Tuple of (success: bool, message: str)
+    """
+    try:
+        config = load_claude_config()
+    except json.JSONDecodeError as e:
+        return False, f"Invalid JSON in Claude config file: {e}"
+    except OSError as e:
+        return False, f"Error reading Claude config file: {e}"
+
+    if "mcpServers" not in config:
+        return False, "No mcpServers section found in Claude config"
+
+    server_name = "qbraid"
+
+    if server_name not in config["mcpServers"]:
+        return False, f"MCP server '{server_name}' not found in config"
+
+    # Remove server
+    del config["mcpServers"][server_name]
+
+    # Save config
+    try:
+        config_path = save_claude_config(config)
+        return True, f"Removed MCP server '{server_name}' from [cyan]{config_path}[/cyan]"
+    except OSError as e:
+        return False, f"Error saving Claude config file: {e}"
+
+
+def get_qbraid_mcp_server_config() -> Optional[dict]:
+    """
+    Get qBraid MCP server configuration from Claude Desktop config.
+
+    Returns:
+        Server configuration dict if found, None otherwise
+    """
+    try:
+        config = load_claude_config()
+    except (json.JSONDecodeError, OSError):
+        return None
+
+    if "mcpServers" not in config:
+        return None
+
+    return config["mcpServers"].get("qbraid")

{qbraid_cli-0.10.9a1.dist-info → qbraid_cli-0.11.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qbraid-cli
-Version: 0.10.9a1
+Version: 0.11.0
 Summary: Command Line Interface for interacting with all parts of the qBraid platform.
 Author-email: qBraid Development Team <contact@qbraid.com>
 License-Expression: LicenseRef-Proprietary

{qbraid_cli-0.10.9a1.dist-info → qbraid_cli-0.11.0.dist-info}/RECORD

@@ -14,7 +14,8 @@ qbraid_cli/chat/__init__.py,sha256=NO41vndEdfr0vDynNcmHFh-nhzWjnWqGm4M9parikck,2
 qbraid_cli/chat/app.py,sha256=-YqCLGDh4ezF149xB3dfuUAQotKAklZwYp0BL3HhA90,2256
 qbraid_cli/configure/__init__.py,sha256=YaJ74Ztz2vl3eYp8_jVBucWkXscxz7EZEIzr70OfuOM,187
 qbraid_cli/configure/actions.py,sha256=Zv-y7iGgj1fwYceMSXrurpK2PyFCIitKXPqCb4H9AZo,3818
-qbraid_cli/configure/app.py,sha256=7UN8Bje0n_s2nDE-cHid8VwOp7gl0jjw9gldyCcZNhI,4164
+qbraid_cli/configure/app.py,sha256=CxzQmWDpCwpNe4HO7sOxJzbFwJ4dayzD8sjzefQvNNE,7260
+qbraid_cli/configure/claude_config.py,sha256=OJqdEA0wr19F4BnZMAxRBf7rA9FehX12VzC6TQ-rr6c,6457
 qbraid_cli/devices/__init__.py,sha256=hiScO-px6jCL5cJj5Hbty55EUfNejTO4bmqUZuS3aqc,181
 qbraid_cli/devices/app.py,sha256=B-cRdV092C6ACeu3C-5l2P_izpPDxvCzzAKfxO1WkaM,3224
 qbraid_cli/devices/validation.py,sha256=YhShyUufgrKnx2XjXOXF-PqFJYklJT9CgeqIwKcNam4,809
@@ -37,9 +38,9 @@ qbraid_cli/mcp/serve.py,sha256=4LFXjuv6CQPIuskPxcFXS0qE2igv1vYmLup-u1xhIZ0,11384
 qbraid_cli/pip/__init__.py,sha256=tJtU0rxn-ODogNh5Y4pp_BgDQXMN-3JY1QGj0OZHwjQ,169
 qbraid_cli/pip/app.py,sha256=jkk-djductrDOJIRYfHK_7WDJ12f0zOT3MMkiZp97oM,1365
 qbraid_cli/pip/hooks.py,sha256=jkIeev3cOd-cmaoJSdSqbmhTYCs6z1we84FMqa3ZoZw,2124
-qbraid_cli-0.10.9a1.dist-info/licenses/LICENSE,sha256=3KvWfsaXBCqbZ4qwk5jN9CQXE53tQeaZTySN5a-CCgQ,2753
-qbraid_cli-0.10.9a1.dist-info/METADATA,sha256=XUWqr6NzCm90QkrwTM7d7p3Ge_MTd_mYY6qdVKzjmQw,7812
-qbraid_cli-0.10.9a1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-qbraid_cli-0.10.9a1.dist-info/entry_points.txt,sha256=c5ZJ7NjbxhDqMpou9q5F03_b_KG34HzFDijIDmEIwgQ,47
-qbraid_cli-0.10.9a1.dist-info/top_level.txt,sha256=LTYJgeYSCHo9Il8vZu0yIPuGdGyNaIw6iRy6BeoZo8o,11
-qbraid_cli-0.10.9a1.dist-info/RECORD,,
+qbraid_cli-0.11.0.dist-info/licenses/LICENSE,sha256=3KvWfsaXBCqbZ4qwk5jN9CQXE53tQeaZTySN5a-CCgQ,2753
+qbraid_cli-0.11.0.dist-info/METADATA,sha256=abpcskHSE3v-4-23dVHTN77lhSTv_aGsYx9OEB4Mrbs,7810
+qbraid_cli-0.11.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+qbraid_cli-0.11.0.dist-info/entry_points.txt,sha256=c5ZJ7NjbxhDqMpou9q5F03_b_KG34HzFDijIDmEIwgQ,47
+qbraid_cli-0.11.0.dist-info/top_level.txt,sha256=LTYJgeYSCHo9Il8vZu0yIPuGdGyNaIw6iRy6BeoZo8o,11
+qbraid_cli-0.11.0.dist-info/RECORD,,