Skip to main content
Glama

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: vault-mcp-bridge

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.

Related MCP Connectors

Related MCP Servers

  • F
    license
    A
    quality
    C
    maintenance
    Provides MCP-compatible AI agents with read access to a LifeOS knowledge base, exposing identity, preferences, projects, wiki, skills, and rules via tools and resources.
    17
    -
  • A
    license
    Not graded
    quality
    B
    maintenance
    Read-only MCP bridge that exposes secure search and fetch tools over an Obsidian-compatible Markdown vault, enabling ChatGPT to query notes without write access.
    1
    Apache 2.0
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables the ChatGPT web app to securely read selected files, git state, and test output from a local workspace through OAuth-protected read-only MCP tools, so TeleAgent retains full execution control.
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    Gives ChatGPT read-only visibility into Paseo-managed coding sessions and repository state, letting users list running agents, review what changed since the last update, inspect bounded diffs and pull project context to reason about architecture and the next task.
    MIT