AI Loop Library MCP 服务器（ailooplibrary-mcp）版本 2.1.0，是一个只读、本地的 MCP 服务器，用于 AI Loop Library 及其 68 个有界工作循环。调用该服务器的智能体根据自身对操作者项目的知识来选择循环；服务器提供可搜索的规格、可运行的协议以及设计检查。
用途与形态：该服务器为单个 Python 文件，运行时仅依赖 Python 3.9+ 标准库。它不包含写入工具、凭据、模型调用，也无需运维托管服务器。可下载该单文件，用于 Cursor 或其他 stdio 客户端；独立仓库包含相同的服务器。安装后，从仓库根目录运行，或从站点仓库的 mcp/ 目录运行。已安装的需重新下载文件或更新克隆后重装，并重启 MCP 连接；现有安装不会自行更新。
核心能力：会话协议（session protocols）遵守轮次（round）和分钟（minute）上限；定时触发协议（scheduled-tick protocols）使用实验日志、每次/总计花费指引，以及连续两次无进展即停止。max_rounds 和 max_minutes 仅适用于会话协议。严格姿态（Strict posture）要求对共享表面操作（shared-surface actions）获得明确批准，包括在复制的提示词中。lint 工具可识别明确的门禁语言，并标记常见否定表述，如“without human approval”或“approval is optional”。关键缺失的验证、停止、预算或批准检查会阻止获得正向总评分。文本匹配无法建立安全性或授予许可，无论分数如何。资源包括 ailooplibrary://catalog 和 ailooplibrary://loop/{id}。所有工具声明 readOnlyHint 和 idempotentHint。
目录加载与故障处理：解析顺序为：AI_LOOP_LIBRARY_CATALOG_PATH（权威本地 JSON 文件，使用 catalog.json 或 data/loops.json 结构；无效的显式路径会失败）；AI_LOOP_LIBRARY_CATALOG_URL（默认 https://ailooplibrary.com/catalog.json）；本地回退：服务器旁的 catalog.json，然后 ../catalog.json，然后 ../data/loops.json。服务器将验证过的目录在内存中缓存五分钟。远程获取有 10 秒超时和 4 MiB 响应限制。验证和搜索索引在替换快照前完成。
如果刷新和本地回退均失败，服务器保留最后验证过的快照，并等待 60 秒后重试。工具响应会包含过期目录警告，以及 _meta["ai-loop-library/catalog"]（包含来源、年龄和过期状态）；catalog_stats 也包含 catalog_status。缓存为进程本地，重启后不保留。更改配置的来源会使旧快照失效。初始故障且没有有效本地目录时返回错误，绝不返回示例数据。嵌入的两个循环样例仅保留用于离线测试。
客户端兼容性：支持的协议版本为 2024-11-05、2025-03-26、2025-06-18。传输方式为基于 stdio 的换行分隔 JSON-RPC 2.0。诊断信息输出到 stderr。格式错误的请求和无效的工具参数会返回协议错误而不终止服务器。执行失败返回 isError: true。请求参数和工具参数在提供时必须是对象；无参数调用时省略它们。这些对象的显式 null 会被有意拒绝，包括对较旧客户端。可空的单个字段仍按各输入 schema 中的声明受到支持。此验证是 2.0.0 以来的有意收紧。
对于 2025-06-18，六个返回 JSON 的工具会声明输出 schema，并在返回相同 JSON 文本的同时返回 structuredContent。更早版本保留仅文本的约定。浏览、设计和渲染工具继续返回 Markdown。
排序与测试：排序使用 IDF 加权的关键词重叠、轻度词干化、同义词和类别提示。它是浏览辅助，不是模型判断或约束求解器。
验证与开发：从包含 server.py 的目录运行。运行时无第三方依赖。可选的测试依赖 jsonschema 独立验证所声明的 schema 和真实工具结果。43 项离线自检和 20 个黄金排序查询与回归套件分开，回归套件覆盖请求恢复、参数验证、旧客户端兼容性、协议保真度、lint 否定、域路由和缓存故障。CI 在 Python 3.9 和 3.13 上运行这些门禁。
发布不变量：站点和独立仓库必须发布相同的 server.py、README.md、pyproject.toml 和 test_server.py 文件。版本元数据必须与 SERVER_VERSION 匹配；独立的 server.json 是注册表提交清单，并不证明已发生 PyPI 或注册表发布。
