Compass

compass-mcp

Compass を通じて、LLM の回答を EU の金融、暗号資産、AI 規制に基づかせる MCP サーバーです。Claude Desktop、Cursor、または任意の MCP ホストに追加すると、モデルは回答する前に、適用される EU の条文を原文のまま、条文単位の引用付きで取得できます。

Compass の公開グラウンディング API を介して、2 つのツールを提供します。

• compass_retrieve：質問を入力すると、主要な EU 法令（MiCA、DORA、MiFID II、AML パッケージ、AI Act、GDPR など）の適用される条文が上位から返されます（原文、条文単位の引用、相互参照付き）。
• compass_verify：引用文が特定の条文からの逐語的な抜粋かどうかを確認し、モデルによる法律の誤引用を防ぎます。

1. API キーを取得する

compass.licentium.ai/developers でキーを作成します。キーは ck_live_... の形式です。最初の呼び出しは無料で、それ以降は Compass クレジットに対して使用量が課金されます。キーは秘密にしてください。

2. インストールしてビルドする

git clone <this-repo> compass-mcp
cd compass-mcp
npm install
npm run build

これにより dist/index.js が生成されます。（npm で公開された後は、ホストで npx -y @licentium/compass-mcp を実行できるため、クローンとビルドは不要です。）

3. MCP ホストを設定する

サーバーの環境で COMPASS_API_KEY にキーを設定します。

Claude Desktop

claude_desktop_config.json を編集します（Settings → Developer → Edit Config）：

{
  "mcpServers": {
    "compass": {
      "command": "node",
      "args": ["/absolute/path/to/compass-mcp/dist/index.js"],
      "env": { "COMPASS_API_KEY": "ck_live_your_key_here" }
    }
  }
}

Claude Desktop を再起動します。ツール一覧に compass_retrieve と compass_verify が表示されます。

Cursor

~/.cursor/mcp.json（またはプロジェクトの .cursor/mcp.json）に追加します：

{
  "mcpServers": {
    "compass": {
      "command": "node",
      "args": ["/absolute/path/to/compass-mcp/dist/index.js"],
      "env": { "COMPASS_API_KEY": "ck_live_your_key_here" }
    }
  }
}

その他の MCP ホスト

COMPASS_API_KEY を設定して、バイナリを stdio 経由で実行します：

COMPASS_API_KEY=ck_live_your_key_here node dist/index.js

ツール

compass_retrieve

パラメーター	型	備考
query	文字列	平易な言葉で記述した規制に関する質問です。
top_k	数値	省略可能です。返す条文の数を 1～20 で指定します（デフォルトは 8）。

適用される条文を原文で返します。各条文には参照（例：MiCA, Article 59）、node_id、および相互参照が含まれます。引用文を確認するには、node_id を compass_verify に渡します。

compass_verify

パラメーター	型	備考
node_id	文字列	compass_retrieve が返した条文の node_id です。
quote	文字列	その条文からの引用として使用する正確なテキストです。

引用文がその条文からの逐語的な抜粋かどうかを返します。

設定

環境変数	必須	デフォルト	備考
COMPASS_API_KEY	はい	（なし）	お使いの ck_live_ キーです。
COMPASS_API_URL	いいえ	https://compass.licentium.ai	セルフホストのエンドポイントを使用する場合にのみ上書きします。

注意事項

Compass が返すのは一次法のテキストのみです。これは調査と適用範囲の特定を支援するツールであり、法的助言ではありません。コーパス内に質問を規律する法令がない場合、compass_retrieve は推測せずに何も返しません。そのため、根拠に基づかない回答を断定しないよう、モデルに指示してください。

ログは stderr に出力されるため、stdio の JSON-RPC ストリームが破損することはありません。