opensanctions-mcp

opensanctions-mcp

MCP サーバーで、OpenSanctions API を通じて制裁対象のスクリーニングやPEPチェックを行います。

AI エージェント（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

1回の呼び出しで、照合、詳細情報の取得、関係性のマッピングを行い、構造化データを返す、コンプライアンス調査を実行します。

"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