Compass MCP

面向常规 ChatGPT 聊天模式，对当前所审阅的 Compass 配置文件和所选技能提供只读 MCP 访问。

Website: https://compass.ariobarin.com/

MCP 端点：https://compass.ariobarin.com/mcp

新鲜度模型

服务器不会内置 Compass 内容。对于每个 MCP 请求，它都会将 ariobarin/compass 的 main 分支解析为一个 Git 提交，然后从该精确修订版本加载 codex/AGENTS.md、manifests/portable-files.json 以及所有选中的技能。

普通请求会将分支头缓存最多 15 秒。不可变的修订目录会在 Worker 隔离环境中复用。GET /healthz?fresh=1 绕过分支头缓存并返回 source_revision，因此 CI 可以将生产环境与已知的 Compass 提交进行比较。

单个请求永远不会混合来自不同 Compass 修订版本的文件。

首页由同一个 Worker 基于同一修订固定的目录渲染而成。它会显示实时的源修订版本、分支和所选技能列表，而无需维护第二份 Compass 内容副本。

Related MCP server: MinerU Document Explorer

工具

• get_profile 返回请求修订版本中的 codex/AGENTS.md。

• list_skills 返回清单所选技能目录及修订版本。

• get_skill 返回请求修订版本中的一个所选 SKILL.md。

• search 和 fetch 通过标准的只读知识形态公开相同的修订固定文档。

本地检查

使用 Node.js 22 或更高版本。

npm install
npm run build
npm test
npm run smoke:worker

使用 npm run dev 运行本地 HTTP 服务器。除非设置了 HOST 或 PORT，否则默认在 127.0.0.1:3000 上侦听。

生产环境验证

npm run smoke:remote
npm run verify:remote

当生产 Worker 报告与当前 main 不同的 Compass 修订版本时，verify:remote 将失败。可设置 EXPECTED_COMPASS_REVISION 与特定提交进行比较，例如 GitHub Actions 中的 GITHUB_SHA。

部署

使用拥有 example.com 的 Cloudflare 账户对 Wrangler 进行身份验证，然后运行：

npm run deploy
npm run smoke:remote
npm run verify:remote

部署仅会更新服务器代码。Compass 内容的变更不需要进行 Worker 部署。