feat: MCP server for programmatic tmux control

pyproject.toml

@@ -112,6 +112,14 @@ lint = [
   "mypy",
 ]
 
+[project.optional-dependencies]
+mcp = [
+    "fastmcp>=3.1.0,<4.0.0; python_version >= '3.10'",
+]
+
+[project.scripts]
+libtmux-mcp = "libtmux.mcp:main"
+
 [project.entry-points.pytest11]
 libtmux = "libtmux.pytest_plugin"
 

src/libtmux/mcp/__init__.py

@@ -0,0 +1,20 @@
+"""libtmux MCP server - programmatic tmux control for AI agents."""
+
+from __future__ import annotations
+
+
+def main() -> None:
+    """Entry point for the libtmux MCP server."""
+    try:
+        from libtmux.mcp.server import run_server
+    except ImportError:
+        import sys
+
+        print(
+            "libtmux MCP server requires fastmcp. "
+            "Install with: pip install libtmux[mcp]",
+            file=sys.stderr,
+        )
+        raise SystemExit(1) from None
+
+    run_server()

src/libtmux/mcp/__main__.py

@@ -0,0 +1,7 @@
+"""Support ``python -m libtmux.mcp``."""
+
+from __future__ import annotations
+
+from libtmux.mcp import main
+
+main()