opensanctions-mcp

opensanctions-mcp

用于通过 OpenSanctions API 进行制裁筛查和 PEP 核查的 MCP 服务。

让 AI Agent（Claude、Cursor、Windsurf、GPT）能够对照 OFAC、EU、UN、UK HMT 等机构的 320 多个制裁和 PEP 名单筛查个人和公司。

**免责声明：**此工具仅提供信息数据，不构成法律或合规建议。采取行动前，请务必通过官方来源核实匹配结果。

快速开始

将以下内容添加到 MCP 客户端配置中：

{
  "mcpServers": {
    "opensanctions": {
      "command": "npx",
      "args": ["-y", "opensanctions-mcp"],
      "env": {
        "OPENSANCTIONS_API_KEY": "your-key-here"
      }
    }
  }
}

前往 opensanctions.org/api 获取免费的 API 密钥。

在哪里添加此配置

• Claude Desktop：~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）
• **Cursor：**Settings > MCP Servers
• Windsurf：~/.windsurf/config.json

工具

search_entities

按名称或关键词搜索 OpenSanctions 数据库。

"Search for entities named Viktor Bout"
"Find companies related to Iran sanctions"

match_entity

使用结构化属性对照制裁和 PEP 名单筛查个人或公司。这是主要的筛查工具。

"Screen Viktor Bout, born 1967-01-13, Russian national, against sanctions lists"
"Check if Acme Corp is on any EU sanctions list"

get_entity

获取特定实体的完整详情，包括与其他实体（公司、关联人士、家庭成员）的关系。

"Get full details for entity NK-2Ciy8EG7jz1YHMGCxYLb25"

list_datasets

列出可用的制裁和 PEP 数据集。无需 API 密钥。

"What sanctions lists are available?"
"Show me EU-related datasets"

get_dataset

获取特定数据集的详情（发布方、实体数量、上次更新时间）。无需 API 密钥。

"Tell me about the OFAC SDN list"

investigate_entity

一次调用即可进行完整的合规调查：匹配、获取详情、梳理关系并返回结构化数据。

"Investigate Viktor Bout for sanctions exposure"
"Run a compliance check on Acme Corp, jurisdiction Belgium"

配置

环境变量	必需	默认值	描述
OPENSANCTIONS_API_KEY	是*	—	托管 OpenSanctions API 的 API 密钥。前往 opensanctions.org/api 获取。
OPENSANCTIONS_API_URL	否	https://api.opensanctions.org	API URL。可设置为可自托管的 yente 实例。
OPENSANCTIONS_DATASET	否	default	用于筛查的数据集。default 包含所有 320 多个来源。
OPENSANCTIONS_MAX_RETRIES	否	3	API 调用失败时的最大重试次数。
DEBUG	否	—	设置任意值即可启用调试日志记录。

*list_datasets、get_dataset 或使用无需身份验证的可自托管 yente 实例时，不需要此密钥。

可自托管的 yente

如果你运行自己的 yente 实例，可将服务指向该实例：

{
  "mcpServers": {
    "opensanctions": {
      "command": "npx",
      "args": ["-y", "opensanctions-mcp"],
      "env": {
        "OPENSANCTIONS_API_URL": "http://localhost:8000"
      }
    }
  }
}

可自托管的 yente 无需 API 密钥。

开发

git clone https://github.com/scka-de/opensanctions-mcp.git
cd opensanctions-mcp
npm install
npm test          # run tests (fixtures, no API key needed)
npm run build     # compile to dist/
npm run dev       # run in dev mode
npm run lint      # check code style

许可证

MIT