"""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]: users_root = Path(os.environ.get("QUALITY_AGENT_USERS_ROOT", "")).resolve() access_path = Path(os.environ.get("QUALITY_AGENT_ACCESS_FILE", "")) evidence_dir = Path(os.environ.get("QUALITY_AGENT_EVIDENCE_DIR", "")) 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", "")) actor_root = users_root / actor_id if users_root != (ROOT / ".runtime" / "nao-users").resolve(): raise ValueError("质量MCP运行目录无效。") if access_path.is_symlink() or access_path.absolute() != actor_root / "access.json": raise ValueError("质量MCP访问凭据路径无效。") expected_evidence = actor_root / session_id / "evidence" if evidence_dir.is_symlink() or evidence_dir.resolve() != expected_evidence.resolve(): raise ValueError("质量MCP证据目录路径无效。") if session_state.is_symlink() or session_state.absolute() != actor_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) class SessionScopedQualityTools(QualityTools): def quality_data(self, arguments): try: current = json.loads(session_state.read_text(encoding="utf-8")) current_session = _uuid(current.get("sessionId"), "sessionId") except Exception: raise ValueError("当前质量分析会话不可用。") from None if not isinstance(current, dict) or current.get("actorId") != actor_id: raise ValueError("当前质量分析 actor 不匹配。") target = users_root / actor_id / current_session / "evidence" if target.is_symlink() or target.resolve().parent.parent != (users_root / actor_id).resolve(): raise ValueError("质量证据目录路径无效。") target.mkdir(parents=True, exist_ok=True, mode=0o700) os.chmod(target, 0o700) self._evidence_dir = target 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")