Compass

compass-mcp

一个 MCP 服务，通过 Compass 为你的大模型提供欧盟金融、加密资产和 AI 监管依据。将其添加到 Claude Desktop、Cursor 或任何 MCP 宿主后，模型便可在回答前获取适用的欧盟条文原文及具体条款引用。

它通过 Compass 的公共依据检索 API 提供两个工具：

• compass_retrieve：输入问题，返回适用的核心欧盟法案（MiCA、DORA、MiFID II、反洗钱法规包、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 后，通过标准输入输出运行二进制文件：

COMPASS_API_KEY=ck_live_your_key_here node dist/index.js

工具

compass_retrieve

参数	类型	说明
query	string	用通俗语言提出的监管问题。
top_k	number	可选。要返回的条文数量，范围为 1 到 20（默认为 8）。

返回适用条文的原文，每条均附有引用（例如 MiCA, Article 59）、node_id 以及任何交叉引用。将 node_id 传给 compass_verify，即可确认引文。

compass_verify

参数	类型	说明
node_id	string	compass_retrieve 返回的条文的 node_id。
quote	string	你打算归引于该条文的确切文本。

返回引文是否为该条文的原文片段。

配置

环境变量	必需	默认值	说明
COMPASS_API_KEY	是	（无）	你的 ck_live_ 密钥。
COMPASS_API_URL	否	https://compass.licentium.ai	仅用于覆盖可自托管端点。

说明

Compass 仅返回一手法律文本。它是用于研究和界定范围的工具，不提供法律建议。当语料库中没有适用的问题依据时，compass_retrieve 会返回空结果，而不是猜测；因此请指示模型不要给出缺乏依据的回答。

日志会写入标准错误输出，不会破坏标准输入输出上的 JSON-RPC 流。