AI Sovereignty Scan Mcp

@kajaril/sovereignty-scan-mcp

用于欧盟《人工智能法案》供应商主权扫描的 MCP 服务。免费层采用 MIT 许可。

在执法机构之前，了解你的技术栈在哪里处理数据。涵盖 12 个类别中的 55 家供应商。

安装

1. 获取免费 API 密钥

curl -s -X POST https://sovereignty-scan.kajaril.com/register \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]"}' | jq .api_key

保存返回的密钥——无法找回。

2. 添加到 claude_desktop_config.json

{
  "mcpServers": {
    "sovereignty-scan": {
      "type": "http",
      "url": "https://sovereignty-scan.kajaril.com/mcp",
      "headers": {
        "Authorization": "Bearer ks_free_YOUR_KEY"
      }
    }
  }
}

重启 Claude Desktop。

客户端兼容性

客户端	状态
Claude Desktop	✓ 支持
Cursor / Windsurf	✓ 支持（HTTP MCP）
claude.ai web	✗ 不支持（不支持 HTTP MCP）

快速测试

验证端点是否正常运行：

curl -s https://sovereignty-scan.kajaril.com/health | jq .

使用你的密钥调用工具：

curl -s -X POST https://sovereignty-scan.kajaril.com/mcp \
  -H "Authorization: Bearer ks_free_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"scan_provider","arguments":{"name":"cloudflare"}}}' \
  | jq .

工具

scan_provider — 获取单家供应商的完整司法辖区概况：总部所在国家、数据驻留区域、欧盟驻留选项、受美国 CLOUD Act 约束的风险、GDPR DPA 是否可用，以及法律框架。

• name — 字符串，不区分大小写

响应示例：

{
  "name": "Cloudflare",
  "hq_country": "US",
  "data_residency_regions": ["US", "EU", "APAC"],
  "eu_residency_option": true,
  "us_cloud_act_subject": true,
  "gdpr_dpa_available": true,
  "legal_framework": "GDPR+SCC"
}

scan_stack — 汇总供应商列表的司法辖区概况：受 CLOUD Act 约束的数量、欧盟驻留覆盖情况、缺失的 DPA。每次调用最多 50 家供应商。

• providers — 字符串数组，最多 50 个

list_providers — 列出所有已跟踪的供应商。可选类别筛选。

• category? — AI · Hosting · Database · Auth · Analytics · Observability · CI/CD · Communications · Payments · Search · Sandbox · Cache

get_us_cloud_act_providers — 列出所有受美国 CLOUD Act 强制披露要求约束的供应商（18 U.S.C. § 2713）。无需参数。

suggest_eu_alternatives — 提供与指定供应商属于同一类别、总部设于欧盟/欧洲经济区/英国/瑞士的替代方案。顺序固定：先欧盟/欧洲经济区，再英国/瑞士。最多 10 个。

• provider_name — 字符串，不区分大小写

定价

	免费	付费
价格	—	€39–149 / 月
许可	MIT	订阅
状态	已上线	即将推出
输出	司法辖区、驻留情况、法律框架、CLOUD Act	+ 专有风险评分 + 补救建议
身份验证	API 密钥（免费注册）	API 密钥
速率限制	每 IP 每天 100 次请求	更高限制

付费层通知：[email protected]

自托管

需要 Cloudflare 账户（Workers + D1 + KV）。

1. 克隆并安装

git clone https://github.com/mightbesaad/sovereignty-scan-mcp
cd sovereignty-scan-mcp
npm install

2. 创建基础设施

npx wrangler d1 create sovereignty-db-free
npx wrangler kv namespace create CACHE_KV
npx wrangler kv namespace create KEYS_KV
npx wrangler rate-limit:namespace create RATE_LIMITER
npx wrangler rate-limit:namespace create BURST_LIMITER

将每条命令打印的 ID 复制到 wrangler.jsonc 中的 d1_databases、kv_namespaces 和 unsafe.bindings 下。

3. 应用架构并填充种子数据

npx wrangler d1 execute sovereignty-db-free --remote --file=migrations/0001_providers.sql
node --input-type=module -e "
  import { generateSeedSQL } from './src/seed.js';
  process.stdout.write(generateSeedSQL());
" | npx wrangler d1 execute sovereignty-db-free --remote --command=-

4. 部署

npx wrangler deploy

默认配置中的自定义域名（sovereignty-scan.kajaril.com）归 kajaril 所有——请移除或替换 routes 条目，使用你自己的域名，或使用默认的 *.workers.dev URL。

健康状态

GET https://sovereignty-scan.kajaril.com/health

返回结构化负载（HTTP 200）：

{
  "status": "ok",
  "provider_count": 55,
  "anthropic_path_count": 3,
  "last_kv_refresh": "2026-05-11T00:00:00.000Z",
  "cache_age_seconds": 86400,
  "schema_version": "0001"
}

如果 D1 可访问，status 为 "ok"；否则为 "degraded"。如果 KV 缓存从未预热，cache_age_seconds 为 null。

许可证

MIT — 参见 LICENSE。