Compass MCP

通常の ChatGPT チャットモード向けに、現在レビュー済みの Compass プロファイルと選択されたスキルへの読み取り専用 MCP アクセスを提供します。

ウェブサイト: https://compass.ariobarin.com/

MCP エンドポイント: https://compass.ariobarin.com/mcp

鮮度モデル

サーバーは Compass の内容を同梱しません。各 MCP リクエストでは、ariobarin/compass の main を 1 つの Git コミットに解決し、その正なリビジョンの codex/AGENTS.md、manifests/portable-files.json、選択されたスキルをすべて読み込みます。

通常のリクエストはブランチヘッドを最大 15 秒間キャッシュします。変更不可のリビジョンカタログは Worker のアイソレート内で再利用されます。GET /healthz?fresh=1 はブランチヘッドのキャッシュをバイパスして source_revision を返すため、CI は本番環境を既知の Compass コミットと比較できます。

1 つのリクエストが異なるリビジョンのファイルを混ぜることはありません。

ホームページは、同じ Worker が同じリビジョン固定のカタログからレンダリングしたものです。Comass の内容の2つ目のコピーを持つことなく、現在のソースリビジョン、ブランチ、選択されたスキルの一覧を表示します。

Related MCP server: MinerU Document Explorer

ツール

• get_profile は、リクエストされたリビジョンの codex/AGENTS.md を返します。

• list_skills は、マニフェストで選択されたスキルのカタログとリビジョンを返します。

• get_skill は、リクエストされたリビジョンから選択された 1 つの 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 などの特定のコミットと比較できます。

デプロイ

ariobarin.com を所有する Cloudflare アカウントで Wrangler を認証し、次を実行します。

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

デプロイはサーバーのコードのみを変更します。Comass の内容の変更に Worker のデプロイは必要ありません。