mcp-ticketer 0.1.14__py3-none-any.whl → 0.1.16__py3-none-any.whl

mcp_ticketer/__version__.py

@@ -1,6 +1,6 @@
 """Version information for mcp-ticketer package."""
 
-__version__ = "0.1.14"
+__version__ = "0.1.16"
 __version_info__ = tuple(int(part) for part in __version__.split("."))
 
 # Package metadata

mcp_ticketer/cli/main.py

@@ -71,10 +71,34 @@ class AdapterType(str, Enum):
 
 
 def load_config() -> dict:
-    """Load configuration from file."""
+    """Load configuration from file.
+
+    Resolution order:
+    1. Project-specific config (.mcp-ticketer/config.json in cwd)
+    2. Global config (~/.mcp-ticketer/config.json)
+
+    Returns:
+        Configuration dictionary
+    """
+    # Check project-specific config first
+    project_config = Path.cwd() / ".mcp-ticketer" / "config.json"
+    if project_config.exists():
+        try:
+            with open(project_config, "r") as f:
+                return json.load(f)
+        except (json.JSONDecodeError, IOError) as e:
+            console.print(f"[yellow]Warning: Could not load project config: {e}[/yellow]")
+            # Fall through to global config
+
+    # Fall back to global config
     if CONFIG_FILE.exists():
-        with open(CONFIG_FILE, "r") as f:
-            return json.load(f)
+        try:
+            with open(CONFIG_FILE, "r") as f:
+                return json.load(f)
+        except (json.JSONDecodeError, IOError) as e:
+            console.print(f"[yellow]Warning: Could not load global config: {e}[/yellow]")
+
+    # Default fallback
     return {"adapter": "aitrackdown", "config": {"base_path": ".aitrackdown"}}
 
 
@@ -1135,7 +1159,7 @@ def check(
 
 
 @app.command()
-def mcp(
+def serve(
     adapter: Optional[AdapterType] = typer.Option(
         None,
         "--adapter",
@@ -1148,10 +1172,22 @@ def mcp(
         help="Base path for AITrackdown adapter"
     ),
 ):
-    """Start MCP server for JSON-RPC communication over stdio."""
+    """Start MCP server for JSON-RPC communication over stdio.
+
+    This command is used by Claude Code/Desktop when connecting to the MCP server.
+    You typically don't need to run this manually - use 'mcp-ticketer mcp' to configure.
+
+    Configuration Resolution:
+    - When MCP server starts, it uses the current working directory (cwd)
+    - The cwd is set by Claude Code/Desktop from the 'cwd' field in .mcp/config.json
+    - Configuration is loaded with this priority:
+      1. Project-specific: .mcp-ticketer/config.json in cwd
+      2. Global: ~/.mcp-ticketer/config.json
+      3. Default: aitrackdown adapter with .aitrackdown base path
+    """
     from ..mcp.server import MCPTicketServer
 
-    # Load configuration
+    # Load configuration (respects project-specific config in cwd)
     config = load_config()
 
     # Determine adapter type
@@ -1194,6 +1230,38 @@ def mcp(
         sys.exit(1)
 
 
+@app.command()
+def mcp(
+    global_config: bool = typer.Option(
+        False,
+        "--global",
+        "-g",
+        help="Configure Claude Desktop instead of project-level"
+    ),
+    force: bool = typer.Option(
+        False,
+        "--force",
+        "-f",
+        help="Overwrite existing configuration"
+    ),
+):
+    """Configure Claude Code to use mcp-ticketer MCP server.
+
+    Reads configuration from .mcp-ticketer/config.json and updates
+    Claude Code's MCP settings accordingly.
+
+    By default, configures project-level (.mcp/config.json).
+    Use --global to configure Claude Desktop instead.
+    """
+    from ..cli.mcp_configure import configure_claude_mcp
+
+    try:
+        configure_claude_mcp(global_config=global_config, force=force)
+    except Exception as e:
+        console.print(f"[red]✗ Configuration failed:[/red] {e}")
+        raise typer.Exit(1)
+
+
 def main():
     """Main entry point."""
     app()

mcp_ticketer/cli/mcp_configure.py

@@ -0,0 +1,285 @@
+"""MCP configuration for Claude Code integration."""
+
+import json
+import os
+import shutil
+import sys
+from pathlib import Path
+from typing import Optional
+
+from rich.console import Console
+
+console = Console()
+
+
+def find_mcp_ticketer_binary() -> str:
+    """Find the mcp-ticketer binary path.
+
+    Returns:
+        Path to mcp-ticketer binary
+
+    Raises:
+        FileNotFoundError: If binary not found
+    """
+    # Check if running from development environment
+    import mcp_ticketer
+    package_path = Path(mcp_ticketer.__file__).parent.parent.parent
+
+    # Check for virtual environment bin
+    possible_paths = [
+        # Development paths
+        package_path / "venv" / "bin" / "mcp-ticketer",
+        package_path / ".venv" / "bin" / "mcp-ticketer",
+        package_path / "test_venv" / "bin" / "mcp-ticketer",
+        # System installation
+        Path.home() / ".local" / "bin" / "mcp-ticketer",
+        # pipx installation
+        Path.home() / ".local" / "pipx" / "venvs" / "mcp-ticketer" / "bin" / "mcp-ticketer",
+    ]
+
+    # Check PATH
+    which_result = shutil.which("mcp-ticketer")
+    if which_result:
+        return which_result
+
+    # Check possible paths
+    for path in possible_paths:
+        if path.exists():
+            return str(path.resolve())
+
+    raise FileNotFoundError(
+        "Could not find mcp-ticketer binary. Please ensure mcp-ticketer is installed.\n"
+        "Install with: pip install mcp-ticketer"
+    )
+
+
+def load_project_config() -> dict:
+    """Load mcp-ticketer project configuration.
+
+    Returns:
+        Project configuration dict
+
+    Raises:
+        FileNotFoundError: If config not found
+        ValueError: If config is invalid
+    """
+    # Check for project-specific config first
+    project_config_path = Path.cwd() / ".mcp-ticketer" / "config.json"
+
+    if not project_config_path.exists():
+        # Check global config
+        global_config_path = Path.home() / ".mcp-ticketer" / "config.json"
+        if global_config_path.exists():
+            project_config_path = global_config_path
+        else:
+            raise FileNotFoundError(
+                "No mcp-ticketer configuration found.\n"
+                "Run 'mcp-ticketer init' to create configuration."
+            )
+
+    with open(project_config_path, "r") as f:
+        config = json.load(f)
+
+    # Validate config
+    if "default_adapter" not in config:
+        raise ValueError("Invalid config: missing 'default_adapter'")
+
+    return config
+
+
+def find_claude_mcp_config(global_config: bool = False) -> Path:
+    """Find or create Claude Code MCP configuration file.
+
+    Args:
+        global_config: If True, use Claude Desktop config instead of project-level
+
+    Returns:
+        Path to MCP configuration file
+    """
+    if global_config:
+        # Claude Desktop configuration
+        if sys.platform == "darwin":  # macOS
+            config_path = Path.home() / "Library" / "Application Support" / "Claude" / "claude_desktop_config.json"
+        elif sys.platform == "win32":  # Windows
+            config_path = Path(os.environ.get("APPDATA", "")) / "Claude" / "claude_desktop_config.json"
+        else:  # Linux
+            config_path = Path.home() / ".config" / "Claude" / "claude_desktop_config.json"
+    else:
+        # Project-level configuration
+        config_path = Path.cwd() / ".mcp" / "config.json"
+
+    return config_path
+
+
+def load_claude_mcp_config(config_path: Path) -> dict:
+    """Load existing Claude MCP configuration or return empty structure.
+
+    Args:
+        config_path: Path to MCP config file
+
+    Returns:
+        MCP configuration dict
+    """
+    if config_path.exists():
+        with open(config_path, "r") as f:
+            return json.load(f)
+
+    # Return empty structure
+    return {"mcpServers": {}}
+
+
+def save_claude_mcp_config(config_path: Path, config: dict) -> None:
+    """Save Claude MCP configuration to file.
+
+    Args:
+        config_path: Path to MCP config file
+        config: Configuration to save
+    """
+    # Ensure directory exists
+    config_path.parent.mkdir(parents=True, exist_ok=True)
+
+    # Write with formatting
+    with open(config_path, "w") as f:
+        json.dump(config, f, indent=2)
+
+
+def create_mcp_server_config(
+    binary_path: str,
+    project_config: dict,
+    cwd: Optional[str] = None
+) -> dict:
+    """Create MCP server configuration for mcp-ticketer.
+
+    Args:
+        binary_path: Path to mcp-ticketer binary
+        project_config: Project configuration from .mcp-ticketer/config.json
+        cwd: Working directory for server (optional)
+
+    Returns:
+        MCP server configuration dict
+    """
+    config = {
+        "command": binary_path,
+        "args": ["serve"],  # Use 'serve' command to start MCP server
+    }
+
+    # Add working directory if provided
+    if cwd:
+        config["cwd"] = cwd
+
+    # Add environment variables based on adapter
+    adapter = project_config.get("default_adapter", "aitrackdown")
+    adapters_config = project_config.get("adapters", {})
+    adapter_config = adapters_config.get(adapter, {})
+
+    env_vars = {}
+
+    # Add adapter-specific environment variables
+    if adapter == "linear" and "api_key" in adapter_config:
+        env_vars["LINEAR_API_KEY"] = adapter_config["api_key"]
+    elif adapter == "github" and "token" in adapter_config:
+        env_vars["GITHUB_TOKEN"] = adapter_config["token"]
+    elif adapter == "jira":
+        if "api_token" in adapter_config:
+            env_vars["JIRA_API_TOKEN"] = adapter_config["api_token"]
+        if "email" in adapter_config:
+            env_vars["JIRA_EMAIL"] = adapter_config["email"]
+
+    if env_vars:
+        config["env"] = env_vars
+
+    return config
+
+
+def configure_claude_mcp(global_config: bool = False, force: bool = False) -> None:
+    """Configure Claude Code to use mcp-ticketer.
+
+    Args:
+        global_config: Configure Claude Desktop instead of project-level
+        force: Overwrite existing configuration
+
+    Raises:
+        FileNotFoundError: If binary or project config not found
+        ValueError: If configuration is invalid
+    """
+    # Step 1: Find mcp-ticketer binary
+    console.print("[cyan]🔍 Finding mcp-ticketer binary...[/cyan]")
+    try:
+        binary_path = find_mcp_ticketer_binary()
+        console.print(f"[green]✓[/green] Found: {binary_path}")
+    except FileNotFoundError as e:
+        console.print(f"[red]✗[/red] {e}")
+        raise
+
+    # Step 2: Load project configuration
+    console.print("\n[cyan]📖 Reading project configuration...[/cyan]")
+    try:
+        project_config = load_project_config()
+        adapter = project_config.get("default_adapter", "aitrackdown")
+        console.print(f"[green]✓[/green] Adapter: {adapter}")
+    except (FileNotFoundError, ValueError) as e:
+        console.print(f"[red]✗[/red] {e}")
+        raise
+
+    # Step 3: Find Claude MCP config location
+    config_type = "Claude Desktop" if global_config else "project-level"
+    console.print(f"\n[cyan]🔧 Configuring {config_type} MCP...[/cyan]")
+
+    mcp_config_path = find_claude_mcp_config(global_config)
+    console.print(f"[dim]Config location: {mcp_config_path}[/dim]")
+
+    # Step 4: Load existing MCP configuration
+    mcp_config = load_claude_mcp_config(mcp_config_path)
+
+    # Step 5: Check if mcp-ticketer already configured
+    if "mcp-ticketer" in mcp_config.get("mcpServers", {}):
+        if not force:
+            console.print("[yellow]⚠ mcp-ticketer is already configured[/yellow]")
+            console.print("[dim]Use --force to overwrite existing configuration[/dim]")
+            return
+        else:
+            console.print("[yellow]⚠ Overwriting existing configuration[/yellow]")
+
+    # Step 6: Create mcp-ticketer server config
+    cwd = str(Path.cwd()) if not global_config else None
+    server_config = create_mcp_server_config(
+        binary_path=binary_path,
+        project_config=project_config,
+        cwd=cwd
+    )
+
+    # Step 7: Update MCP configuration
+    if "mcpServers" not in mcp_config:
+        mcp_config["mcpServers"] = {}
+
+    mcp_config["mcpServers"]["mcp-ticketer"] = server_config
+
+    # Step 8: Save configuration
+    try:
+        save_claude_mcp_config(mcp_config_path, mcp_config)
+        console.print(f"\n[green]✓ Successfully configured mcp-ticketer[/green]")
+        console.print(f"[dim]Configuration saved to: {mcp_config_path}[/dim]")
+
+        # Print configuration details
+        console.print("\n[bold]Configuration Details:[/bold]")
+        console.print(f"  Server name: mcp-ticketer")
+        console.print(f"  Adapter: {adapter}")
+        console.print(f"  Binary: {binary_path}")
+        if cwd:
+            console.print(f"  Working directory: {cwd}")
+        if "env" in server_config:
+            console.print(f"  Environment variables: {list(server_config['env'].keys())}")
+
+        # Next steps
+        console.print("\n[bold cyan]Next Steps:[/bold cyan]")
+        if global_config:
+            console.print("1. Restart Claude Desktop")
+            console.print("2. Open a conversation")
+        else:
+            console.print("1. Restart Claude Code")
+            console.print("2. Open this project in Claude Code")
+        console.print("3. mcp-ticketer tools will be available in the MCP menu")
+
+    except Exception as e:
+        console.print(f"\n[red]✗ Failed to save configuration:[/red] {e}")
+        raise

mcp_ticketer/cli/utils.py

@@ -31,10 +31,34 @@ class CommonPatterns:
 
     @staticmethod
     def load_config() -> dict:
-        """Load configuration from file."""
+        """Load configuration from file.
+
+        Resolution order:
+        1. Project-specific config (.mcp-ticketer/config.json in cwd)
+        2. Global config (~/.mcp-ticketer/config.json)
+
+        Returns:
+            Configuration dictionary
+        """
+        # Check project-specific config first
+        project_config = Path.cwd() / ".mcp-ticketer" / "config.json"
+        if project_config.exists():
+            try:
+                with open(project_config, "r") as f:
+                    return json.load(f)
+            except (json.JSONDecodeError, IOError) as e:
+                console.print(f"[yellow]Warning: Could not load project config: {e}[/yellow]")
+                # Fall through to global config
+
+        # Fall back to global config
         if CommonPatterns.CONFIG_FILE.exists():
-            with open(CommonPatterns.CONFIG_FILE, "r") as f:
-                return json.load(f)
+            try:
+                with open(CommonPatterns.CONFIG_FILE, "r") as f:
+                    return json.load(f)
+            except (json.JSONDecodeError, IOError) as e:
+                console.print(f"[yellow]Warning: Could not load global config: {e}[/yellow]")
+
+        # Default fallback
         return {"adapter": "aitrackdown", "config": {"base_path": ".aitrackdown"}}
 
     @staticmethod

{mcp_ticketer-0.1.14.dist-info → mcp_ticketer-0.1.16.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-ticketer
-Version: 0.1.14
+Version: 0.1.16
 Summary: Universal ticket management interface for AI agents with MCP support
 Author-email: MCP Ticketer Team <support@mcp-ticketer.io>
 Maintainer-email: MCP Ticketer Team <support@mcp-ticketer.io>

{mcp_ticketer-0.1.14.dist-info → mcp_ticketer-0.1.16.dist-info}/RECORD

@@ -1,5 +1,5 @@
 mcp_ticketer/__init__.py,sha256=ayPQdFr6msypD06_G96a1H0bdFCT1m1wDtv8MZBpY4I,496
-mcp_ticketer/__version__.py,sha256=BR9V-DmEH6HYXFWNVQkJRJ36WxlCMQn4UvkIRrMi6_c,1115
+mcp_ticketer/__version__.py,sha256=VU-W9BGb5-hfF3jvOPn-c-W8RnOMrAL8rswIa9JjVSE,1115
 mcp_ticketer/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mcp_ticketer/adapters/__init__.py,sha256=K_1egvhHb5F_7yFceUx2YzPGEoc7vX-q8dMVaS4K6gw,356
 mcp_ticketer/adapters/aitrackdown.py,sha256=gqS_N6VGLoG5itUu17ANG5SefaAITYoW-t2xL9SrY-Y,15372
@@ -12,10 +12,11 @@ mcp_ticketer/cache/memory.py,sha256=gTzv-xF7qGfiYVUjG7lnzo0ZcqgXQajMl4NAYUcaytg,
 mcp_ticketer/cli/__init__.py,sha256=YeljyLtv906TqkvRuEPhmKO-Uk0CberQ9I6kx1tx2UA,88
 mcp_ticketer/cli/configure.py,sha256=etFutvc0QpaVDMOsZiiN7wKuaT98Od1Tj9W6lsEWw5A,16351
 mcp_ticketer/cli/discover.py,sha256=putWrGcctUH8K0fOMtr9MZA9VnWoXzbtoe7mXSkDxhg,13156
-mcp_ticketer/cli/main.py,sha256=mhM7sYSVZ4kHhmsj5bNrK3jOTDjlWZwpSrXPAU2KjtI,38073
+mcp_ticketer/cli/main.py,sha256=WGYXZ0r0Iv296qrCMZLPGHUAWagRhkAgqAm-lJSnyUY,40428
+mcp_ticketer/cli/mcp_configure.py,sha256=1WbBdF25OvxfAGcjxtYa9xmBOGEPQu-wh_nkefmWjMQ,9352
 mcp_ticketer/cli/migrate_config.py,sha256=iZIstnlr9vkhiW_MlnSyJOkMi4KHQqrZ6Hz1ECD_VUk,6045
 mcp_ticketer/cli/queue_commands.py,sha256=f3pEHKZ43dBHEIoCBvdfvjfMB9_WJltps9ATwTzorY0,8160
-mcp_ticketer/cli/utils.py,sha256=NxsS91vKA8xZnDXKU2y0Gcyc4I_ctRyJj-wT7Xd1Q_Q,18589
+mcp_ticketer/cli/utils.py,sha256=cdP-7GHtELAPZtqInUC24k_SAnRbIRkafIP3T4kMZDM,19509
 mcp_ticketer/core/__init__.py,sha256=qpCZveQMyqU2JvYG9MG_c6X35z_VoSmjWdXGcUZqqmA,348
 mcp_ticketer/core/adapter.py,sha256=6KfhceINHfDjs--RyA_rOLeM2phVD_D85S9D6s2lcuU,10075
 mcp_ticketer/core/config.py,sha256=9a2bksbcFr7KXeHSPY6KoSP5Pzt54utYPCmbM-1QKmk,13932
@@ -33,9 +34,9 @@ mcp_ticketer/queue/manager.py,sha256=79AH9oUxdBXH3lmJ3kIlFf2GQkWHL6XB6u5JqVWPq60
 mcp_ticketer/queue/queue.py,sha256=z4aivQCtsH5_OUr2OfXSfnFKzugTahNnwHw0LS3ZhZc,11549
 mcp_ticketer/queue/run_worker.py,sha256=HFoykfDpOoz8OUxWbQ2Fka_UlGrYwjPVZ-DEimGFH9o,802
 mcp_ticketer/queue/worker.py,sha256=cVjHR_kfnGKAkiUg0HuXCnbKeKNBBEuj0XZHgIuIn4k,14017
-mcp_ticketer-0.1.14.dist-info/licenses/LICENSE,sha256=KOVrunjtILSzY-2N8Lqa3-Q8dMaZIG4LrlLTr9UqL08,1073
-mcp_ticketer-0.1.14.dist-info/METADATA,sha256=AD51kbqeeWDh5nalVzmsmypReM-1f2cajlksTYJVouc,11211
-mcp_ticketer-0.1.14.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-mcp_ticketer-0.1.14.dist-info/entry_points.txt,sha256=o1IxVhnHnBNG7FZzbFq-Whcs1Djbofs0qMjiUYBLx2s,60
-mcp_ticketer-0.1.14.dist-info/top_level.txt,sha256=WnAG4SOT1Vm9tIwl70AbGG_nA217YyV3aWFhxLH2rxw,13
-mcp_ticketer-0.1.14.dist-info/RECORD,,
+mcp_ticketer-0.1.16.dist-info/licenses/LICENSE,sha256=KOVrunjtILSzY-2N8Lqa3-Q8dMaZIG4LrlLTr9UqL08,1073
+mcp_ticketer-0.1.16.dist-info/METADATA,sha256=2Fa_rzfQvRRW-6e52xz_umAJlztAjQn1DMSQaTzcTEE,11211
+mcp_ticketer-0.1.16.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+mcp_ticketer-0.1.16.dist-info/entry_points.txt,sha256=o1IxVhnHnBNG7FZzbFq-Whcs1Djbofs0qMjiUYBLx2s,60
+mcp_ticketer-0.1.16.dist-info/top_level.txt,sha256=WnAG4SOT1Vm9tIwl70AbGG_nA217YyV3aWFhxLH2rxw,13
+mcp_ticketer-0.1.16.dist-info/RECORD,,