claude-team-mcp 0.2.0__py3-none-any.whl → 0.3.0__py3-none-any.whl

claude_team_mcp/__init__.py

@@ -12,8 +12,8 @@ from .colors import generate_tab_color, get_hue_for_index, hsl_to_rgb_tuple
 
 def main():
     """Entry point for the claude-team command."""
-    from .server import run_server
-    run_server()
+    from .server import main as server_main
+    server_main()
 
 
 __all__ = [

claude_team_mcp/server.py

@@ -32,6 +32,22 @@ logging.basicConfig(
 logger = logging.getLogger("claude-team-mcp")
 
 
+# =============================================================================
+# Singleton Registry (persists across MCP sessions for HTTP mode)
+# =============================================================================
+
+_global_registry: SessionRegistry | None = None
+
+
+def get_global_registry() -> SessionRegistry:
+    """Get or create the global singleton registry."""
+    global _global_registry
+    if _global_registry is None:
+        _global_registry = SessionRegistry()
+        logger.info("Created global singleton registry")
+    return _global_registry
+
+
 # =============================================================================
 # Application Context
 # =============================================================================
@@ -162,11 +178,11 @@ async def app_lifespan(server: FastMCP) -> AsyncIterator[AppContext]:
         logger.error("Make sure iTerm2 is running and Python API is enabled")
         raise RuntimeError("Could not connect to iTerm2") from e
 
-    # Create application context with session registry
+    # Create application context with singleton registry (persists across sessions)
     ctx = AppContext(
         iterm_connection=connection,
         iterm_app=app,
-        registry=SessionRegistry(),
+        registry=get_global_registry(),
     )
 
     try:
@@ -180,16 +196,25 @@ async def app_lifespan(server: FastMCP) -> AsyncIterator[AppContext]:
 
 
 # =============================================================================
-# FastMCP Server
+# FastMCP Server Factory
 # =============================================================================
 
-mcp = FastMCP(
-    "Claude Team Manager",
-    lifespan=app_lifespan,
-)
 
-# Register all tools from the tools package
-register_all_tools(mcp, ensure_connection)
+def create_mcp_server(host: str = "127.0.0.1", port: int = 8766) -> FastMCP:
+    """Create and configure the FastMCP server instance."""
+    server = FastMCP(
+        "Claude Team Manager",
+        lifespan=app_lifespan,
+        host=host,
+        port=port,
+    )
+    # Register all tools from the tools package
+    register_all_tools(server, ensure_connection)
+    return server
+
+
+# Default server instance for stdio mode (backwards compatibility)
+mcp = create_mcp_server()
 
 
 # =============================================================================
@@ -311,11 +336,48 @@ async def resource_session_screen(
 # =============================================================================
 
 
-def run_server():
-    """Run the MCP server with stdio transport."""
-    logger.info("Starting Claude Team MCP Server...")
-    mcp.run(transport="stdio")
+def run_server(transport: str = "stdio", port: int = 8766):
+    """
+    Run the MCP server.
+
+    Args:
+        transport: Transport mode - "stdio" or "streamable-http"
+        port: Port for HTTP transport (default 8766)
+    """
+    if transport == "streamable-http":
+        logger.info(f"Starting Claude Team MCP Server (HTTP on port {port})...")
+        # Create server with configured port for HTTP mode
+        server = create_mcp_server(host="127.0.0.1", port=port)
+        server.run(transport="streamable-http")
+    else:
+        logger.info("Starting Claude Team MCP Server (stdio)...")
+        mcp.run(transport="stdio")
+
+
+def main():
+    """CLI entry point with argument parsing."""
+    import argparse
+
+    parser = argparse.ArgumentParser(description="Claude Team MCP Server")
+    parser.add_argument(
+        "--http",
+        action="store_true",
+        help="Run in HTTP mode (streamable-http) instead of stdio",
+    )
+    parser.add_argument(
+        "--port",
+        type=int,
+        default=8766,
+        help="Port for HTTP mode (default: 8766)",
+    )
+
+    args = parser.parse_args()
+
+    if args.http:
+        run_server(transport="streamable-http", port=args.port)
+    else:
+        run_server(transport="stdio")
 
 
 if __name__ == "__main__":
-    run_server()
+    main()

claude_team_mcp/tools/close_workers.py

@@ -113,16 +113,15 @@ def register_tools(mcp: FastMCP) -> None:
         Gracefully terminates the Claude sessions in parallel and closes
         their iTerm2 panes. All session_ids must exist in the registry.
 
-        ⚠️ **WARNING: DESTRUCTIVE FOR WORKTREES**
+        ⚠️ **NOTE: WORKTREE CLEANUP**
         Workers with worktrees commit to ephemeral branches. When closed:
         - The worktree directory is removed
-        - The worktree branch is deleted
-        - Commits on that branch become orphaned (recoverable via reflog, but awkward)
+        - The branch is KEPT for cherry-picking/merging
 
-        **BEFORE closing workers with worktrees:**
-        1. Review their code changes
-        2. Merge or cherry-pick their commits to a persistent branch
-        3. THEN close workers
+        **AFTER closing workers with worktrees:**
+        1. Review commits on the worker's branch
+        2. Merge or cherry-pick commits to a persistent branch
+        3. Delete the branch when done: `git branch -D <branch-name>`
 
         Args:
             session_ids: List of session IDs to close (1 or more required).

{claude_team_mcp-0.2.0.dist-info → claude_team_mcp-0.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-team-mcp
-Version: 0.2.0
+Version: 0.3.0
 Summary: MCP server for managing multiple Claude Code sessions via iTerm2
 Project-URL: Homepage, https://github.com/Martian-Engineering/claude-team
 Project-URL: Repository, https://github.com/Martian-Engineering/claude-team

{claude_team_mcp-0.2.0.dist-info → claude_team_mcp-0.3.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-claude_team_mcp/__init__.py,sha256=tkMR1aFZQsWElyouRRT35UnTYkF8L7BXzYyLxnq6pSc,471
+claude_team_mcp/__init__.py,sha256=HnGWRX1P2CxUafElaxq6zXvXznQeUF5XiQBqu9eJU0Q,481
 claude_team_mcp/__main__.py,sha256=JOG9n8ZCjy3JN96T0n97Ro-ZWtOU-RTJks7ahz81NRM,134
 claude_team_mcp/colors.py,sha256=f-PcPep9WkZ7zbt-IF0Ey4OXfZeiY-y2uXERFtiY8Pk,3270
 claude_team_mcp/formatting.py,sha256=myyzR6sbBapsmo5e5_dK3X5qk8ww2NbNkmo0DpHxDxs,3181
@@ -7,7 +7,7 @@ claude_team_mcp/iterm_utils.py,sha256=S2s4X1svQoDwsHcphIaHMIGXBIJxeRublGavk-m08v
 claude_team_mcp/names.py,sha256=M-84kICkGP4W2LOK94Jzf5O0Gg9AuYpCPfJ-6fq9GjA,15894
 claude_team_mcp/profile.py,sha256=yqytAE0dIe6NQ6FodldSepO-ZIeR7-C0UfK3FsO7Pn4,12326
 claude_team_mcp/registry.py,sha256=6JLrKgbb_9_wfg8CuVLgWRWv3M5eXVKC5QW8DTUGoIQ,12808
-claude_team_mcp/server.py,sha256=1i4jXx_pJOMtc4tiWcUpHAXcE0oV6Z1oL_yiAnkb1S0,10365
+claude_team_mcp/server.py,sha256=nyBHhL-ke2Mj4YVsEQWyTi0b-mHf7hnsen1-PcRsg5c,12374
 claude_team_mcp/session_state.py,sha256=3kg5sLMp4jcIAJOE6pmXOhdFA9oz-fGkOzK3wsaemnM,27420
 claude_team_mcp/subprocess_cache.py,sha256=6Q1NIMn2X5_75S4s_a9iPBka-UCz6RW0EMxPSPEaLxo,3612
 claude_team_mcp/worker_prompt.py,sha256=olzVr6iHbYeb8sOThIJgVqrqc9uttgBvYzqI3v1J1rE,6207
@@ -17,7 +17,7 @@ claude_team_mcp/tools/adopt_worker.py,sha256=oWSamOzOqnLPWADWb4tk7qSPHroxIhQXkFD
 claude_team_mcp/tools/annotate_worker.py,sha256=mBo4YMaaaNQxQBduYK1DPA-Ioift-ZQ9tYlBM6S15t8,1639
 claude_team_mcp/tools/bd_help.py,sha256=kA3DnMGG48ruIt7L-tcUPfevy_l-Yy22pa3I20DZU2A,1402
 claude_team_mcp/tools/check_idle_workers.py,sha256=IjDNDeal9M7lTONWjKZrt8bXu7O277ossHz_2oyLRcY,3374
-claude_team_mcp/tools/close_workers.py,sha256=5odUqOwKKIqVKNQ8IDTgAqSSV-iCd38OkL2gxGKAZcE,6672
+claude_team_mcp/tools/close_workers.py,sha256=glVUNM5Q32z8DyzvNKpxExN9pDR16rzjuyzEjI-eInM,6633
 claude_team_mcp/tools/discover_workers.py,sha256=PkdnURZBex_y0kFx_pv-EgWrEbtQtsg5TjqycNs7BJI,5437
 claude_team_mcp/tools/examine_worker.py,sha256=7Nd3EOdsGVDjMJ8ov9NhmcrjN8K9IE4i_noXHOP1uI8,1620
 claude_team_mcp/tools/list_workers.py,sha256=6cvsgHOYtakkSgoZdYez4VEQ3I8aWAKaGWhfiZyPf2c,2390
@@ -30,7 +30,7 @@ claude_team_mcp/utils/__init__.py,sha256=_O-de711DxfMdjCAHHoifyOtzdllciE9FFV-tZ5
 claude_team_mcp/utils/constants.py,sha256=gvWbqk1qaymilnAvql28ZiNnvWG4vsz7cYg84mtd6PY,2264
 claude_team_mcp/utils/errors.py,sha256=9uPFHp7UJYB5t3p7P_5Sh3PVpYh4_vj_RLzX5GcJPEU,2738
 claude_team_mcp/utils/worktree_detection.py,sha256=NfEK8c_toFiz8dqF2ht1FJzW9a9VstVm7Y5SNXvwAD8,2564
-claude_team_mcp-0.2.0.dist-info/METADATA,sha256=XQelCS4u_wrdJltcKqIPsj55xoIJ_oatkqAdN8DYzKE,14438
-claude_team_mcp-0.2.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-claude_team_mcp-0.2.0.dist-info/entry_points.txt,sha256=cmk5dmK50RVquExT-k_J72akl3qKIerPpVqfit7kQtQ,53
-claude_team_mcp-0.2.0.dist-info/RECORD,,
+claude_team_mcp-0.3.0.dist-info/METADATA,sha256=KgQ8Jg9OChMe2DDBRQCpWZaakqTPvLxVFVvlHJko9k0,14438
+claude_team_mcp-0.3.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+claude_team_mcp-0.3.0.dist-info/entry_points.txt,sha256=cmk5dmK50RVquExT-k_J72akl3qKIerPpVqfit7kQtQ,53
+claude_team_mcp-0.3.0.dist-info/RECORD,,