Compass MCP

Read-only MCP access to the current reviewed Compass profile and selected skills for regular ChatGPT chat mode.

Veb-sayт: https://compass.arioбerin.com/

MCP end-point: https://compass.arioerin.com/mcp

Model свежести

Сервер не встраивает содержимое Compass. Дляeach each MCP-request он resolves ariobirin/compass main in one Git-коммит, and then загружает codex/AGENTS.md, manifests/portable-files.json and all selected skiills in this exact revision.

Оычные requests кэшируют голову ветки на срок до 15 секунд. Именяемые каталоги рevизий perисползуются inside изоля Worker. GET /healthz?fresh=1 обходит кэш головы ветки и возвращает source_revision, так CI CI может compare sell with known commit.

Один запрос никогда не смешивает файлы из different Compass revisions.

Домашная страница рендерится тем же Worker e из того же ревизитель каталог. Она shows current source version, branch and list of selected skills, no need to maintain duplicate copy of Compass content.

Related MCP server: MinerU Document Explorer

Tools

• get_profile returns codex/AGENTS.md from the request revision.

• list_skills returns the list of skills selected in the manifest and the revision itself.

• get_skill returns one selected SKILL.md file from the request revision.

• search and fetch provide the same revision-specific documents through standard read-only knowledge forms.

Local checks

Use Node.js 22 or newer.

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

Run the local HTTP server with npm run dev. It listens on 127.0.0.1:3000 unless HOST or PORT is specified.

Production check

verify:remote will fail if the production Worker reports a Compass revision different from the current main. Set EXPECTED_COMPASS_REVISION to compare against a specific commit, for example, a GITHUB_SHA from GitHub Actions.

npm run smoke:remote
npm run verify:remote

Deployment

Authenticate Wrangler with the Cloudflare account that owns ariobarin.com, then run:

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

Deployments change only the server code. Changes to Compass content do not require a deployment of the Worker.