Gleif Mcp Server

GLEIF MCP サーバー

1つの質問で、あらゆる企業の法的な身元を確認できます。LEI コードを検索し、取引相手を検証して、GLEIF の公式データベースを使って企業の所有構造をたどれます。200以上の法域にわたる280万以上の法人を網羅しています。

LEI 検索、法人検索、BIC/SWIFT の照合、企業の所有構造、バッチ検証に対応する12個のツールを利用できます。Claude Desktop、Claude Code、Cursor、VS Code、Windsurf など、MCP 互換ツールで動作します。

使用例

• KYC とオンボーディング：契約締結前に取引相手の身元を確認
• コンプライアンスチェック：MiFID II、EMIR、DORA の報告に必要な LEI を検証
• デューデリジェンス：企業の所有関係や最終親会社を調査
• 財務分析：証券（ISIN）や銀行（BIC/SWIFT）を、それぞれの法人と照合
• データ拡充：企業リストを一括処理して LEI データを追加

LEI とは？

LEI（Legal Entity Identifier、取引主体識別子）は、世界中の金融取引に参加する法人を一意に識別する20文字の英数字コードです。MiFID II、EMIR、ドッド・フランク法、DORA など、200以上の規制で義務付けられています。

LEI の形式（ISO 17442）：

• 1～4文字目：LOU（Local Operating Unit）プレフィックス
• 5～18文字目：法人固有の識別子
• 19～20文字目：チェックディジット（mod 97 による検証）

例：HWUPKR0MPOU8FGXBT394（Apple Inc.）

機能

主な機能

• LEI 検索：LEI コードから法人の詳細情報を取得
• 一括検索：1回のリクエストで複数の LEI を検索（最大100件）
• 法人検索：あいまい検索とページネーションを使って、名称から企業を検索
• LEI 検証：形式、チェックディジット（ISO 17442）、登録状況を確認

金融識別子

• BIC/SWIFT 検索：BIC コードから銀行の LEI を検索
• ISIN 検索：ISIN コードから証券発行体の LEI を検索
• 国別表示：法域ごとに法人を一覧表示

関係とコンプライアンス

• 企業の所有構造：親会社、子会社、最終親会社
• ファンドの関係：ファンドマネージャー、アンブレラファンド、サブファンド
• 報告例外：理由を含むレベル2データの例外
• LEI 発行機関：すべての Local Operating Unit（LOU）の一覧と詳細

パフォーマンスと信頼性

• 高速な応答：結果はローカルにキャッシュされるため、同じ問い合わせには即座に応答します
• API キー不要：GLEIF の公開 API ですぐに利用できます
• エラーを適切に処理：タイムアウトや一時的な障害時に自動で再試行します
• 利用制限を遵守：組み込みのレート制限により、GLEIF の割り当て上限を超えないようにします

インストール

バイナリをダウンロード

すべてのプラットフォーム向けのビルド済みバイナリは、リリースページから入手できます。

プラットフォーム	バイナリ
macOS（Apple Silicon）	gleif-mcp-server-darwin-arm64
macOS（Intel）	gleif-mcp-server-darwin-amd64
Linux（x64）	gleif-mcp-server-linux-amd64
Linux（ARM64）	gleif-mcp-server-linux-arm64
Windows（x64）	gleif-mcp-server-windows-amd64.exe

# macOS/Linux - download and make executable
chmod +x gleif-mcp-server-darwin-arm64

ソースからビルド

Go 1.25 以降が必要です。

git clone https://github.com/olgasafonova/gleif-mcp-server.git
cd gleif-mcp-server
go build -o gleif-mcp-server .

Go でインストール

go install github.com/olgasafonova/gleif-mcp-server@latest

AI エージェントのセットアップ

**最も手早く始める方法：**Claude Desktop をお使いですか？以下の設定を追加して再起動するだけです。Cursor のような IDE をお使いですか？手順は同じで、設定ファイルが異なります。以下からお使いのツールを選んでください。

Claude Desktop

ステップ 1：バイナリをダウンロードする

リリースページにアクセスし、お使いのシステムに対応するバイナリをダウンロードします。

• Mac（Apple Silicon M1/M2/M3/M4）： gleif-mcp-server-darwin-arm64
• Mac（Intel）： gleif-mcp-server-darwin-amd64
• Windows： gleif-mcp-server-windows-amd64.exe

ステップ 2：Mac のみ — ファイルの実行を許可する

macOS はダウンロードしたファイルをブロックします。ターミナルを開いて、次を実行します。

chmod +x ~/Downloads/gleif-mcp-server-darwin-arm64
xattr -d com.apple.quarantine ~/Downloads/gleif-mcp-server-darwin-arm64

ステップ 3：設定ファイルを開く

Mac： Finder を開き、Cmd + Shift + G を押して、次のパスを貼り付けます。

~/Library/Application Support/Claude/

Windows： Win + R を押して、次のパスを貼り付けます。

%APPDATA%\Claude

claude_desktop_config.json を開きます。存在しない場合は作成します。

ステップ 4：設定を追加する

Mac（YOUR_USERNAME を実際のユーザー名に置き換えてください）：

{
  "mcpServers": {
    "gleif": {
      "command": "/Users/YOUR_USERNAME/Downloads/gleif-mcp-server-darwin-arm64"
    }
  }
}

Windows（YOUR_USERNAME を置き換えてください。バックスラッシュが 2 つ並ぶ点に注意してください）：

{
  "mcpServers": {
    "gleif": {
      "command": "C:\\Users\\YOUR_USERNAME\\Downloads\\gleif-mcp-server-windows-amd64.exe"
    }
  }
}

ユーザー名を確認するには、Mac ではターミナルを開いて whoami と入力します。Windows では C:\Users\ を確認します。

ステップ 5：Claude Desktop を再起動する

完全に終了し（Mac では Cmd + Q）、再度開きます。

ステップ 6：テストする

Claude Desktop に次のように入力します。

Look up Apple's LEI using GLEIF

Claude が GLEIF ツールを呼び出し、企業データを返すことを確認してください。

Claude Code（CLI）

# Add the server
claude mcp add gleif /path/to/gleif-mcp-server

# Or with scope for all projects
claude mcp add --scope user gleif /path/to/gleif-mcp-server

Cursor IDE

プロジェクトの .cursor/mcp.json、またはグローバル設定の場合は ~/.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "gleif": {
      "command": "/path/to/gleif-mcp-server"
    }
  }
}

Continue 拡張機能を使用した VS Code

.continue/config.json に追加します。

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "name": "gleif",
        "transport": {
          "type": "stdio",
          "command": "/path/to/gleif-mcp-server"
        }
      }
    ]
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json に追加します。

{
  "mcpServers": {
    "gleif": {
      "command": "/path/to/gleif-mcp-server"
    }
  }
}

Cline（VS Code 拡張機能）

Cline の MCP 設定から追加するか、.vscode/cline_mcp_settings.json に追加します。

{
  "mcpServers": {
    "gleif": {
      "command": "/path/to/gleif-mcp-server",
      "args": []
    }
  }
}

Antigravity

~/.antigravity/mcp.json に追加します。

{
  "mcpServers": {
    "gleif": {
      "command": "/path/to/gleif-mcp-server"
    }
  }
}

動作しませんか？ 難しかった点をお知らせください。一言だけでも役立ちます。

ツールリファレンス

コア検索ツール

ツール	説明	パラメーター
lei_lookup	特定の LEI の詳細情報をすべて取得します	lei（必須）：20 文字の LEI コード
validate_lei	書式、チェックディジット、ステータスを確認します	lei（必須）：検証する LEI
batch_lei_lookup	複数の LEI を一度に検索します	leis（必須）：カンマ区切りの LEI（最大 100 件）

検索ツール

ツール	説明	パラメーター
search_entity	企業名で検索します	query（必須）、limit（デフォルト 20）、page（デフォルト 1）、fuzzy（デフォルト true）
search_by_bic	BIC/SWIFT から LEI を検索します	bic（必須）：8 または 11 文字のコード
search_by_isin	ISIN から発行体の LEI を検索します	isin（必須）：12 文字の ISIN
search_by_country	国別に事業体を一覧表示します	country（必須）：ISO 2 文字のコード、limit（デフォルト 20）
autocomplete	事業体名の候補を表示します	prefix（必須）：2 文字以上、limit（デフォルト 10）

関係ツール

ツール	説明	パラメーター
get_relationships	企業／ファンドの関係を取得します	lei（必須）、type：direct-parent、ultimate-parent、children、fund-manager、umbrella-fund、sub-funds

LEI 発行者ツール

ツール	説明	パラメーター
get_lei_issuer	LOU の詳細を取得します	issuer_id（必須）：LOU 識別子
list_lei_issuers	世界中のすべての LOU を一覧表示します	なし

コンプライアンスツール

ツール	説明	パラメーター
get_reporting_exceptions	レベル 2 の報告例外を取得します	lei（必須）：確認する LEI

使用例

LEI の基本検索

プロンプト：「LEI HWUPKR0MPOU8FGXBT394 を検索してください」

**戻り値：**Apple Inc. の事業体に関する詳細情報。正式名称、本社住所、管轄区域（US-CA）、事業体のステータス、登録ステータス、管理 LOU、次回更新日が含まれます。

企業検索（ページネーション対応）

プロンプト：「Deutsche Bankを検索して、2ページ目を表示」

ツール呼び出し：

{
  "name": "search_entity",
  "arguments": {
    "query": "Deutsche Bank",
    "limit": 20,
    "page": 2,
    "fuzzy": true
  }
}

**返される内容：**ページネーション情報（検索結果の総数、現在のページ、続きがあるかどうか）を含む、一致するエンティティの一覧です。

LEIの一括検索

プロンプト：「次のLEIを検索してください：HWUPKR0MPOU8FGXBT394, 5493006MHB84DD0ZWV18, 549300GKFG0RYRRQ1414」

**返される内容：**3つのエンティティすべてについて、LEI、法人名、国、都市、ステータスをまとめた情報です。

BICで銀行を検索

プロンプト：「BIC DEUTDEFFのLEIを検索してください」

**返される内容：**Deutsche Bank AGのLEIレコードと詳細情報です。

証券発行体を検索

プロンプト：「ISIN US0378331005の発行体はどこですか？」

**返される内容：**Apple Inc.（AAPL株の発行体）です。

企業構造

プロンプト：「この子会社の最終親会社はどこですか？」

ツール呼び出し：

{
  "name": "get_relationships",
  "arguments": {
    "lei": "549300GKFG0RYRRQ1414",
    "type": "ultimate-parent"
  }
}

LEIの検証

プロンプト：「LEI HWUPKR0MPOU8FGXBT394は有効ですか？」

返される内容：

{
  "lei": "HWUPKR0MPOU8FGXBT394",
  "valid": true,
  "status": "ISSUED",
  "entityStatus": "ACTIVE",
  "nextRenewal": "2025-08-15"
}

報告例外の確認

プロンプト：「この企業の親会社情報がないのはなぜですか？」

ツール呼び出し：

{
  "name": "get_reporting_exceptions",
  "arguments": {
    "lei": "5493006MHB84DD0ZWV18"
  }
}

**返される内容：**例外のカテゴリと理由（例：NON_CONSOLIDATING、NATURAL_PERSONS）です。

すべてのLEI発行機関を一覧表示

プロンプト：「すべてのLEI発行機関を表示してください」

**返される内容：**LOU（Local Operating Units）の完全な一覧です。名称、国、ステータス、発行したLEIの数が含まれます。

レスポンス形式

すべてのツールは、関連フィールドを含むJSONを返します。エンティティレコードの例：

{
  "lei": "HWUPKR0MPOU8FGXBT394",
  "legalName": "Apple Inc.",
  "country": "US",
  "city": "Cupertino",
  "status": "ACTIVE",
  "regStatus": "ISSUED"
}

検索結果にはページネーション情報が含まれます。

{
  "count": 20,
  "results": [...],
  "pagination": {
    "currentPage": 1,
    "perPage": 20,
    "total": 156,
    "lastPage": 8
  },
  "hasMore": true
}

エラー処理

サーバーは構造化されたエラーを返します。

エラーコード	説明	再試行可能
not_found	GLEIFデータベースにLEI／エンティティが見つかりません	いいえ
invalid_format	LEI／BIC／ISINの形式が無効です	いいえ
rate_limited	GLEIF APIのレート制限を超過しました	はい
timeout	リクエストがタイムアウトしました	はい
server_error	GLEIF APIのエラーです	ステータスによります
network_error	接続に失敗しました	はい

エラーレスポンスの例：

{
  "code": "not_found",
  "message": "LEI not found in GLEIF database",
  "statusCode": 404,
  "retryable": false
}

アーキテクチャ

gleif-mcp-server/
├── main.go                 # Entry point, MCP server setup
├── internal/gleif/
│   ├── client.go          # GLEIF API client with caching & rate limiting
│   ├── client_test.go     # Client and validation tests
│   ├── cache.go           # LRU cache with TTL
│   ├── types.go           # Data structures for API responses
│   └── errors.go          # Structured error types
└── tools/
    ├── definitions.go     # Tool metadata and parameter specs
    ├── handlers.go        # MCP tool implementations
    └── handlers_test.go   # Handler tests with mock server

技術的な詳細

詳細を確認したい開発者向けの情報です。

設定	値
キャッシュ期間	15分
キャッシュ容量	エンティティ1000件、検索500件
レート制限	50リクエスト／分（GLEIFの上限は60）
再試行戦略	指数バックオフを使用して3回試行
コネクションプール	アイドル接続の最大数100、ホストごとに10

APIリファレンス

このサーバーは公開GLEIF APIをラップします。

• ベースURL： https://api.gleif.org/api/v1
• 認証：不要
• レート制限：1分あたり60リクエスト
• ドキュメント： https://www.gleif.org/en/lei-data/gleif-api

トラブルシューティング

サーバーが起動しない

• バイナリに実行権限があることを確認してください：chmod +x gleif-mcp-server
• MCP設定内のパスが相対パスではなく絶対パスであることを確認してください

「レート制限を超過しました」エラー

• サーバーは再試行によってレート制限を自動的に処理します
• エラーが続く場合は、同時リクエストを減らすか、数分待ってください

有効なLEIに対して「LEIが見つかりません」と表示される

• GLEIFデータベースは毎日更新されるため、新しく発行されたLEIはすぐに表示されない場合があります
• LEIの形式が正しいこと（英数字20文字ちょうど）を確認してください

応答が遅い

• 初回のリクエストは、キャッシュの準備中に時間がかかる場合があります
• GLEIF APIで遅延が急増することがありますが、再試行によって自動的に対処されます

Claude Desktopにサーバーが表示されない

• 設定を編集した後、Claude Desktopを再起動してください
• 設定ファイルのJSON構文を確認してください
• バイナリのパスが存在し、実行可能であることを確認してください

開発

# Run tests
go test ./...

# Run tests with coverage
go test -coverprofile=coverage.out ./...
go tool cover -html=coverage.out

# Run tests with race detector
go test -race ./...

# Build
go build -o gleif-mcp-server .

貢献

貢献を歓迎します。変更案について話し合うため、まずイシューを作成してください。

ライセンス

MIT License — 詳細はLICENSEを参照してください。

その他の MCP サーバー

私のその他の MCP サーバーもご覧ください。

サーバー	説明	スター数
mediawiki-mcp-server	AI をあらゆる MediaWiki のウィキに接続します。ウィキのコンテンツを検索、閲覧、編集できます。
miro-mcp-server	AI で Miro のホワイトボードを操作できます。ボード、図、マインドマップなどに対応しています。
nordic-registry-mcp-server	北欧の企業登記情報にアクセスできます。ノルウェー、デンマーク、フィンランド、スウェーデンの企業を検索できます。
productplan-mcp-server	ProductPlan のロードマップについてやり取りできます。OKR、アイデア、ローンチを検索できます。
tilbudstrolden-mcp	北欧の食料品のお得情報を探せます。セールを見つけ、食事を計画し、支出を追跡できます。

---

謝辞

• 公開 LEI API を提供する GLEIF に感謝します
• MCP 仕様を提供する Model Context Protocol に感謝します