__main__.py

Go to the documentation of this file.

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
# oct/mcp/__main__.py
 
"""
Entry point for ``python -m oct.mcp``.
 
Usage
-----
    python -m oct.mcp [--project-root PATH] [--profile PROFILE]
                      [--transport {stdio,sse}] [--host HOST] [--port PORT]
                      [--metrics-port PORT]
 
Options
-------
--project-root PATH
    Absolute or relative path to the Option C project root.
    Defaults to auto-discovery from the current working directory.
 
--profile PROFILE
    MCP security profile: ``default``, ``strict``, or ``airgapped``.
    Overrides ``OCT_MCP_PROFILE`` and the config file value.
 
--config PATH
    Path to the user-level config file.
    Defaults to ``~/.oct-mcp/config.json``.
 
--transport {stdio,sse}
    MCP transport. ``stdio`` (default) for local AI host integration
    (Claude Code, Cursor, VS Code). ``sse`` for HTTP/SSE remote access.
 
--host HOST
    Bind host for SSE transport (default: ``127.0.0.1``).
    Only used with ``--transport sse``. Use ``0.0.0.0`` with caution
    and only behind a reverse proxy with TLS and authentication.
 
--port PORT
    Bind port for SSE transport (default: ``3001``).
    Only used with ``--transport sse``.
 
--metrics-port PORT
    Start a Prometheus ``/metrics`` HTTP server on this port.
    Disabled by default. Requires ``oct[metrics]`` to be installed.
 
Environment variables
---------------------
OCT_MCP_SAFE_MODE=1        Block all tool calls (emergency kill-switch).
OCT_TRUST_REPO_CONFIG=1    Trust project-level config (debug_config.json).
OCT_MCP_PROFILE=<name>     Override active profile.
OCT_MCP_SANDBOX=<name>     Override sandbox backend (auto/native/bubblewrap/sandbox_exec).
"""
 
from __future__ import annotations
 
import argparse
import sys
from pathlib import Path
 
 
def _parse_args(argv: list[str] | None = None) -> argparse.Namespace:
    parser = argparse.ArgumentParser(
        prog="python -m oct.mcp",
        description="Option C Tools MCP server.",
    )
    parser.add_argument(
        "--project-root",
        metavar="PATH",
        default=None,
        help="Project root directory (default: auto-discover from cwd).",
    )
    parser.add_argument(
        "--profile",
        choices=["default", "strict", "airgapped"],
        default=None,
        help="MCP security profile (default: from config or 'default').",
    )
    parser.add_argument(
        "--config",
        metavar="PATH",
        default=None,
        help="Path to ~/.oct-mcp/config.json (default: standard location).",
    )
    parser.add_argument(
        "--transport",
        choices=["stdio", "sse"],
        default="stdio",
        help=(
            "MCP transport: 'stdio' (default) for local AI host integration, "
            "'sse' for HTTP/SSE remote access."
        ),
    )
    parser.add_argument(
        "--host",
        default="127.0.0.1",
        help=(
            "Bind host for SSE transport (default: 127.0.0.1). "
            "Only used with --transport sse."
        ),
    )
    parser.add_argument(
        "--port",
        type=int,
        default=3001,
        help="Bind port for SSE transport (default: 3001). Only used with --transport sse.",
    )
    parser.add_argument(
        "--metrics-port",
        type=int,
        default=None,
        metavar="PORT",
        help=(
            "Start a Prometheus /metrics HTTP server on this port. "
            "Disabled by default. Requires oct[metrics]."
        ),
    )
    return parser.parse_args(argv)
 
 
def main(argv: list[str] | None = None) -> None:
    """Parse CLI arguments and start the MCP server."""
    args = _parse_args(argv)
    config_path = Path(args.config) if args.config else None
 
    try:
        from oct.mcp.server import start_server
        start_server(
            project_root=args.project_root,
            profile=args.profile,
            config_path=config_path,
            transport=args.transport,
            host=args.host,
            port=args.port,
            metrics_port=args.metrics_port,
        )
    except KeyboardInterrupt:
        sys.exit(0)
 
 
if __name__ == "__main__":
    main()