Compass MCP

일반 ChatGPT 채팅 모드에서 현재 검토된 Compass 프로필과 선정된 스킬에 대한 윽기 전용 MCP 액세스를 재공합니다.

웹사이트: 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 isolate 내에서 재사용됩니다. GET /healthz?fresh=1은 브랜치 헤드 캐시를 우회하고 source_revision을 반환하므로, CI는 프로덕션을 알려진 Compass 커밋과 비교할 수 있습니다.

단일 요청은 서로 다른 Compass 리비전의 파일을 혼합하지 않습니다.

홈페이지는 동일한 Worker가 동일한 리비전 고정 카탈로그로 렌더링합니다. 홈페이지에는 실시간 소스 리비전, 브랜치, 선택된 스킬 목록이 표시되며, Compass 콘텐츠의 사본을 추가로 유지하지 않습니다.

Related MCP server: MinerU Document Explorer

도구

• get_profile은 요청 리비전의 codex/AGENTS.md를 반환합니다.

• list_skills는 manifest에서 선택된 스킬 카탈로그와 리비전을 반환합니다.

• 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

verify:remote는 프로덕션 Worker가 현재 main과 다른 Compass 리비전을 보고하면 실패합니다. 특정 커밋(예: GitHub Actions의 GITHUB_SHA)과 비교하려면 EXPECTED_COMPASS_REVISION을 설정하세요.

배포

ariobarin.com을 소유한 Cloudflare 계정으로 Wrangler를 인증한 다음 아래를 실행하세요:

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

배포는 서버 코드만 변경합니다. Compass 콘텐츠 변경에는 Worker 배포가 필요하지 않습니다.