"""NAO stdio MCP shim backed by per-actor delegated quality API access.""" from __future__ import annotations import os import sys import json import logging from pathlib import Path ROOT = Path(__file__).resolve().parents[1] sys.path.insert(0, str(ROOT / "scripts")) from nao_quality_runtime import DelegatedApi, _uuid # noqa: E402 from nao_quality_tools import QualityTools # noqa: E402 import nao_quality_mcp # noqa: E402 def _paths() -> tuple[Path, Path, Path, str, str, Path]: configured_root = Path(os.environ.get("QUALITY_AGENT_USERS_ROOT", "")).absolute() if configured_root.is_symlink(): raise ValueError("质量MCP运行目录无效。") users_root = configured_root.resolve() access_path = Path(os.environ.get("QUALITY_AGENT_ACCESS_FILE", "")).absolute() evidence_dir = Path(os.environ.get("QUALITY_AGENT_EVIDENCE_DIR", "")).absolute() actor_id = _uuid(os.environ.get("QUALITY_AGENT_ACTOR_ID"), "actorId") session_id = _uuid(os.environ.get("QUALITY_AGENT_SESSION_ID"), "sessionId") session_state = Path(os.environ.get("QUALITY_AGENT_SESSION_STATE_FILE", "")).absolute() actor_root = users_root / actor_id sessions_root = actor_root / "sessions" session_root = sessions_root / session_id private_root = session_root / "private" if users_root != (ROOT / ".runtime" / "nao-users").resolve(): raise ValueError("质量MCP运行目录无效。") for path in (actor_root, sessions_root, session_root, private_root, access_path, evidence_dir, session_state): if path.is_symlink(): raise ValueError("质量MCP会话路径无效。") if access_path != session_root / "access.json": raise ValueError("质量MCP访问凭据路径无效。") expected_evidence = session_root / "evidence" if evidence_dir != expected_evidence: raise ValueError("质量MCP证据目录路径无效。") if session_state != session_root / "private" / "current-session.json": raise ValueError("质量MCP会话状态路径无效。") evidence_dir.mkdir(parents=True, exist_ok=True, mode=0o700) os.chmod(evidence_dir, 0o700) return access_path, evidence_dir, session_state, actor_id, session_id, users_root def main() -> int: access_path, evidence_dir, session_state, actor_id, session_id, users_root = _paths() adapter = DelegatedApi(access_path, runtime_root=users_root, expected_actor_id=actor_id, expected_session_id=session_id) class SessionScopedQualityTools(QualityTools): def quality_data(self, arguments): try: current = json.loads(session_state.read_text(encoding="utf-8")) except Exception: raise ValueError("当前质量分析会话不可用。") from None if (not isinstance(current, dict) or current.get("actorId") != actor_id or current.get("sessionId") != session_id): raise ValueError("当前质量分析 actor/session 不匹配。") self._evidence_dir = evidence_dir return super().quality_data(arguments) tools = SessionScopedQualityTools(api_factory=lambda: adapter, evidence_dir=evidence_dir) # The upstream serve loop stays intact; protocol details go to stdout and # no shared log file can mix evidence from different actors or sessions. def quiet_logger(): logger = logging.getLogger("nao_quality_mcp") logger.handlers.clear() logger.addHandler(logging.NullHandler()) logger.propagate = False return logger nao_quality_mcp._configure_logger = quiet_logger nao_quality_mcp.serve(tools=tools) return 0 if __name__ == "__main__": try: raise SystemExit(main()) except Exception: # MCP stderr is consumed by NAO and must never contain request bodies, # access tokens or stack frames. The upstream server's own safe MCP # errors are still returned through the JSON-RPC protocol. raise SystemExit("quality MCP unavailable")