mcp-ticketer 0.2.0__py3-none-any.whl → 2.2.9__py3-none-any.whl

mcp_ticketer/mcp/server/server_sdk.py

@@ -0,0 +1,151 @@
+"""FastMCP-based MCP server implementation.
+
+This module implements the MCP server using the official FastMCP SDK,
+replacing the custom JSON-RPC implementation. It provides a cleaner,
+more maintainable approach with automatic schema generation and
+better error handling.
+
+The server manages a global adapter instance that is configured at
+startup and used by all tool implementations.
+"""
+
+import logging
+from typing import Any
+
+from mcp.server.fastmcp import FastMCP
+
+from ...core.adapter import BaseAdapter
+from ...core.registry import AdapterRegistry
+
+# Initialize FastMCP server
+mcp = FastMCP("mcp-ticketer")
+
+# Global adapter instance
+_adapter: BaseAdapter | None = None
+
+# Global router instance (optional, for multi-platform support)
+_router: Any | None = None
+
+# Configure logging
+logger = logging.getLogger(__name__)
+
+
+def configure_adapter(adapter_type: str, config: dict[str, Any]) -> None:
+    """Configure the global adapter instance.
+
+    This must be called before starting the server to initialize the
+    adapter that will handle all ticket operations.
+
+    Args:
+        adapter_type: Type of adapter to create (e.g., "linear", "jira", "github")
+        config: Configuration dictionary for the adapter
+
+    Raises:
+        ValueError: If adapter type is not registered
+        RuntimeError: If adapter configuration fails
+
+    """
+    global _adapter
+
+    try:
+        # Get adapter from registry
+        _adapter = AdapterRegistry.get_adapter(adapter_type, config)
+        logger.info(f"Configured {adapter_type} adapter for MCP server")
+    except Exception as e:
+        logger.error(f"Failed to configure adapter: {e}")
+        raise RuntimeError(f"Adapter configuration failed: {e}") from e
+
+
+def get_adapter() -> BaseAdapter:
+    """Get the configured adapter instance.
+
+    Returns:
+        The global adapter instance
+
+    Raises:
+        RuntimeError: If adapter has not been configured
+
+    """
+    if _adapter is None:
+        raise RuntimeError(
+            "Adapter not configured. Call configure_adapter() before starting server."
+        )
+    return _adapter
+
+
+def configure_router(
+    default_adapter: str, adapter_configs: dict[str, dict[str, Any]]
+) -> None:
+    """Configure multi-platform routing support (optional).
+
+    This enables URL-based ticket access across multiple platforms in a
+    single MCP session. When configured, tools will use the router to
+    automatically detect the platform from URLs.
+
+    Args:
+        default_adapter: Default adapter for plain IDs (e.g., "linear")
+        adapter_configs: Configuration for each adapter
+            Example: {
+                "linear": {"api_key": "...", "team_id": "..."},
+                "github": {"token": "...", "owner": "...", "repo": "..."}
+            }
+
+    Raises:
+        RuntimeError: If router configuration fails
+
+    """
+    global _router
+
+    try:
+        from .routing import TicketRouter
+
+        _router = TicketRouter(
+            default_adapter=default_adapter, adapter_configs=adapter_configs
+        )
+        logger.info(f"Configured multi-platform router with default: {default_adapter}")
+    except Exception as e:
+        logger.error(f"Failed to configure router: {e}")
+        raise RuntimeError(f"Router configuration failed: {e}") from e
+
+
+def get_router() -> Any:
+    """Get the configured router instance (if available).
+
+    Returns:
+        The global router instance, or None if not configured
+
+    """
+    return _router
+
+
+def has_router() -> bool:
+    """Check if multi-platform router is configured.
+
+    Returns:
+        True if router is available, False otherwise
+
+    """
+    return _router is not None
+
+
+# Import all tool modules to register them with FastMCP
+# These imports must come after mcp is initialized but before main()
+from . import tools  # noqa: E402, F401
+
+
+def main() -> None:
+    """Run the FastMCP server.
+
+    This function starts the server using stdio transport for
+    JSON-RPC communication with Claude Desktop/Code.
+
+    The adapter must be configured via configure_adapter() before
+    calling this function.
+
+    """
+    # Run the server with stdio transport
+    mcp.run(transport="stdio")
+
+
+if __name__ == "__main__":
+    main()

mcp_ticketer/mcp/server/tools/__init__.py

@@ -0,0 +1,69 @@
+"""MCP tool modules for ticket operations.
+
+This package contains all FastMCP tool implementations organized by
+functional area. Tools are automatically registered with the FastMCP
+server when imported.
+
+Modules:
+    ticket_tools: Basic CRUD operations for tickets
+    hierarchy_tools: Epic/Issue/Task hierarchy management
+    search_tools: Search and query operations
+    bulk_tools: Bulk create and update operations
+    comment_tools: Comment management
+    config_tools: Configuration management (adapter, project, user settings)
+    session_tools: Session tracking and ticket association management
+    user_ticket_tools: User-specific ticket operations (my tickets, transitions)
+    analysis_tools: Ticket analysis and cleanup tools (similar, stale, orphaned)
+    label_tools: Label management, normalization, deduplication, and cleanup
+    project_update_tools: Project status update management (1M-238)
+    project_status_tools: Project status analysis and work planning (1M-316)
+    milestone_tools: Milestone management and progress tracking (1M-607)
+
+Note:
+    instruction_tools: Removed from MCP server (CLI-only as of Phase 2 Sprint 2.3)
+    pr_tools: Removed from MCP server (CLI-only as of Phase 2 Sprint 1.3)
+    attachment_tools: Removed from MCP server (CLI-only as of Phase 2 Sprint 1.3)
+    These tools are available via CLI commands but not exposed through MCP interface.
+    Use filesystem MCP for file operations and GitHub MCP for PR management.
+
+"""
+
+# Import all tool modules to register them with FastMCP
+# Order matters - import core functionality first
+from . import (
+    analysis_tools,  # noqa: F401
+    # attachment_tools removed - CLI-only (Phase 2 Sprint 1.3 - use filesystem MCP)
+    bulk_tools,  # noqa: F401
+    comment_tools,  # noqa: F401
+    config_tools,  # noqa: F401
+    hierarchy_tools,  # noqa: F401
+    # instruction_tools removed - CLI-only (Phase 2 Sprint 2.3)
+    label_tools,  # noqa: F401
+    milestone_tools,  # noqa: F401
+    # pr_tools removed - CLI-only (Phase 2 Sprint 1.3 - use GitHub MCP)
+    project_status_tools,  # noqa: F401
+    project_update_tools,  # noqa: F401
+    search_tools,  # noqa: F401
+    session_tools,  # noqa: F401
+    ticket_tools,  # noqa: F401
+    user_ticket_tools,  # noqa: F401
+)
+
+__all__ = [
+    "analysis_tools",
+    # "attachment_tools" removed - CLI-only (Phase 2 Sprint 1.3)
+    "bulk_tools",
+    "comment_tools",
+    "config_tools",
+    "hierarchy_tools",
+    # "instruction_tools" removed - CLI-only (Phase 2 Sprint 2.3)
+    "label_tools",
+    "milestone_tools",
+    # "pr_tools" removed - CLI-only (Phase 2 Sprint 1.3)
+    "project_status_tools",
+    "project_update_tools",
+    "search_tools",
+    "session_tools",
+    "ticket_tools",
+    "user_ticket_tools",
+]