Gleif Mcp Server

GLEIF MCP Server

只需一个问题，即可验证任意公司的法定身份。查询 LEI 代码、验证交易对手，并使用 GLEIF 官方数据库追溯企业所有权结构。覆盖 200 多个司法管辖区的 280 万多个实体。

提供 12 个工具，用于查询 LEI、搜索实体、交叉查询 BIC/SWIFT、查询企业所有权以及批量验证。适用于 Claude Desktop、Claude Code、Cursor、VS Code、Windsurf 及其他兼容 MCP 的工具。

使用场景

• KYC 与开户：签订合同前验证交易对手身份
• 合规检查：验证 LEI，以用于 MiFID II、EMIR 或 DORA 报告
• 尽职调查：调查企业所有权链和最终母公司
• 金融分析：将证券（ISIN）和银行（BIC/SWIFT）与其法定实体交叉查询
• 数据补充：批量处理公司名单，添加 LEI 数据

什么是 LEI？

法定实体识别编码（LEI）是一个由 20 个字母数字字符组成的代码，用于在全球范围内唯一标识参与金融交易的法定实体。包括 MiFID II、EMIR、Dodd-Frank 和 DORA 在内的 200 多项法规均要求使用 LEI。

LEI 格式（ISO 17442）：

• 第 1–4 位：LOU（本地运营单位）前缀
• 第 5–18 位：实体专属标识符
• 第 19–20 位：校验位（mod 97 验证）

示例：HWUPKR0MPOU8FGXBT394（Apple Inc.）

功能

核心功能

• LEI 查询：通过 LEI 代码获取完整的实体详情
• 批量查询：在单次请求中查询多个 LEI（最多 100 个）
• 实体搜索：通过名称查找公司，支持模糊匹配和分页
• LEI 验证：验证格式、校验位（ISO 17442）和注册状态

金融标识符

• BIC/SWIFT 查询：通过 BIC 代码查找银行的 LEI
• ISIN 查询：通过 ISIN 代码查找证券发行方的 LEI
• 按国家/地区浏览：按司法管辖区列出实体

关系与合规

• 企业所有权：母公司、子公司、最终母公司
• 基金关系：基金经理、伞型基金、子基金
• 报告例外：包含原因的第 2 级数据例外
• LEI 发行方：列出所有本地运营单位（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 Agent 设置

**最快上手方式：**使用 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）

# 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"
    }
  }
}

VS Code 搭配 Continue 扩展

添加到 .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	获取 Level 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”

**返回：**这三个实体的摘要，包含 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（地方运营单位）的完整列表，包含名称、国家、状态和已赞助的 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
• 身份验证：无需身份验证
• 速率限制：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 .

贡献

欢迎贡献。请先提交 issue，讨论拟议的更改。

许可证

MIT 许可证——详情请参阅 LICENSE。

更多 MCP 服务

查看我的其他 MCP 服务：

服务	描述	星标
mediawiki-mcp-server	将 AI 连接到任何 MediaWiki 维基。搜索、阅读和编辑维基内容。
miro-mcp-server	使用 AI 操控 Miro 白板。创建看板、图表、思维导图等。
nordic-registry-mcp-server	访问北欧商业注册信息。查询挪威、丹麦、芬兰和瑞典的公司。
productplan-mcp-server	查询你的 ProductPlan 路线图。检索 OKR、创意和发布计划。
tilbudstrolden-mcp	寻找北欧超市优惠。查找折扣、规划餐食并追踪开支。

---

致谢

• 感谢 GLEIF 提供公开的 LEI API
• 感谢 Model Context Protocol 提供 MCP 规范