Gleif MCP Server

🚀 GLEIF MCP 服務器

通過一個問題即可驗證任何公司的合法身份。利用官方 GLEIF 數據庫查詢 LEI 代碼、驗證交易對手並追蹤公司所有權結構。覆蓋 200 多個司法管轄區的 280 多萬個實體。

提供 29 種工具，用於 LEI 查詢、實體搜索、BIC/SWIFT 交叉引用、公司所有權查詢和批量驗證。可與 Claude Desktop、Claude Code、Cursor、VS Code、Windsurf 等 MCP 兼容工具配合使用。

🚀 快速開始

GLEIF MCP 服務器能夠幫助用戶通過官方 GLEIF 數據庫，快速驗證公司的合法身份、查詢 LEI 代碼等。以下將為你介紹其安裝和使用的相關內容。

✨ 主要特性

核心功能

• LEI 查詢：通過 LEI 代碼獲取完整的實體詳細信息。
• 批量查詢：在單個請求中查詢多個 LEI（最多 100 個）。
• 實體搜索：通過名稱模糊匹配和分頁查找公司。
• LEI 驗證：驗證格式、校驗位（ISO 17442）和註冊狀態。

金融標識符查詢

• BIC/SWIFT 查詢：從 BIC 代碼查找銀行 LEI。
• ISIN 查詢：從 ISIN 代碼查找證券發行人 LEI。
• 國家瀏覽：按司法管轄區列出實體。

關係與合規性

• 公司所有權：查詢母公司、子公司和最終母公司。
• 基金關係：查詢基金經理、傘形基金和子基金。
• 報告異常：提供二級數據異常及原因。
• LEI 發行機構：列出所有本地運營單位（LOU）及其詳細信息。

性能與可靠性

• 快速響應：結果本地緩存，重複查詢即時返回。
• 無需 API 密鑰：直接使用 GLEIF 的公共 API。
• 優雅處理錯誤：在超時或臨時故障時自動重試。
• 遵守限制：內置速率限制，防止超出 GLEIF 的配額。

📦 安裝指南

下載二進制文件

可在 發佈頁面 下載適用於所有平臺的預構建二進制文件：

# macOS/Linux - 下載並設置可執行權限
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 替換為你的實際用戶名 - 注意使用雙反斜槓）：

{
  "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）

# 添加服務器
claude mcp add gleif /path/to/gleif-mcp-server

# 或者為所有項目添加範圍
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 查詢

提示："Look up LEI HWUPKR0MPOU8FGXBT394"

返回：蘋果公司的完整實體詳細信息，包括法定名稱、總部地址、司法管轄區（美國加利福尼亞州）、實體狀態、註冊狀態、管理 LOU 和下次續期日期。

帶分頁的公司搜索

提示："Search for Deutsche Bank, show page 2"

工具調用：

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

返回：包含分頁信息（總結果數、當前頁面、是否有更多結果）的匹配實體列表。

批量 LEI 查詢

提示："Look up these LEIs: HWUPKR0MPOU8FGXBT394, 5493006MHB84DD0ZWV18, 549300GKFG0RYRRQ1414"

返回：三個實體的摘要信息，包括 LEI、法定名稱、國家、城市和狀態。

通過 BIC 查找銀行

提示："Find the LEI for BIC DEUTDEFF"

返回：德意志銀行股份公司的 LEI 記錄及完整詳細信息。

查找證券發行人

提示："Who issued ISIN US0378331005?"

返回：蘋果公司（AAPL 股票的發行人）。

公司結構查詢

提示："Who is the ultimate parent of this subsidiary?"

工具調用：

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

LEI 驗證

提示："Is LEI HWUPKR0MPOU8FGXBT394 valid?"

返回：

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

檢查報告異常

提示："Why is parent info missing for this company?"

工具調用：

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

返回：異常類別和原因（例如，NON_CONSOLIDATING、NATURAL_PERSONS）。

列出所有 LEI 發行機構

提示："Show me all LEI issuers"

返回：所有本地運營單位（LOU）的完整列表，包括名稱、國家、狀態和贊助的 LEI 數量。

📚 詳細文檔

工具參考

核心查詢工具

搜索工具

關係工具

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
}

錯誤處理

服務器返回結構化錯誤信息：

示例錯誤響應：

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

🔧 技術細節

架構

gleif-mcp-server/
├── main.go                 # 入口點，MCP 服務器設置
├── internal/gleif/
│   ├── client.go          # 帶有緩存和速率限制的 GLEIF API 客戶端
│   ├── client_test.go     # 客戶端和驗證測試
│   ├── cache.go           # 帶有 TTL 的 LRU 緩存
│   ├── types.go           # API 響應的數據結構
│   └── errors.go          # 結構化錯誤類型
└── tools/
    ├── definitions.go     # 工具元數據和參數規範
    ├── handlers.go        # MCP 工具實現
    └── handlers_test.go   # 帶有模擬服務器的處理程序測試

具體技術設置

API 參考

此服務器封裝了 GLEIF 公共 API：

• 基礎 URL：https://api.gleif.org/api/v1
• 認證：無需認證
• 速率限制：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 語法
• 驗證二進制文件路徑是否存在且可執行

開發

# 運行測試
go test ./...

# 運行帶覆蓋率的測試
go test -coverprofile=coverage.out ./...
go tool cover -html=coverage.out

# 運行帶競態檢測器的測試
go test -race ./...

# 構建
go build -o gleif-mcp-server .

貢獻

歡迎貢獻代碼。請先打開一個問題討論建議的更改。

📄 許可證

本項目採用 MIT 許可證 - 詳情請參閱 LICENSE。

更多 MCP 服務器

查看我的其他 MCP 服務器：

服務器	描述	星標數
mediawiki-mcp-server	將 AI 連接到任何 MediaWiki 維基。搜索、讀取和編輯維基內容。
miro-mcp-server	使用 AI 控制 Miro 白板。處理板、圖表、思維導圖等。
nordic-registry-mcp-server	訪問北歐商業註冊中心。查詢挪威、丹麥、芬蘭、瑞典的公司信息。
productplan-mcp-server	與你的 ProductPlan 路線圖進行交互。查詢 OKR、想法和發佈信息。

致謝

• GLEIF 提供公共 LEI API
• Model Context Protocol 提供 MCP 規範