Gleif MCP Server

GLEIF MCP服务器

在一个问题中验证任何公司的合法身份。查找LEI代码，验证交易对手，并使用官方GLEIF数据库跟踪公司所有权结构。涵盖200多个司法管辖区的280多万个实体。

29工具 用于LEI查找、实体搜索、BIC/SWIFT交叉引用、公司所有权和批量验证。可与Claude Desktop、Claude Code、Cursor、VS Code、Windsurf和其他MCP兼容工具配合使用。

用例

• KYC和入职培训：在签署合同之前验证交易对手身份
• 合规检查：验证MiFID II、EMIR或DORA报告的LEI
• 尽职调查：研究公司所有权链和最终母公司
• 财务分析：交叉参考证券（ISIN）和银行（BIC/SWIFT）与其法人实体
• 数据富集：批量处理公司列表以添加LEI数据

什么是LEI？

法人实体标识符（LEI）是一个20个字符的字母数字代码，用于唯一标识参与全球金融交易的法人实体。它是由包括MiFID II、EMIR、Dodd-Frank和DORA在内的200多项法规强制执行的。

LEI格式（ISO 17442）：

• 字符1-4:LOU（本地操作单元）前缀
• 字符5-18：实体特定标识符
• 字符19-20：校验数字（mod 97验证）

例子： HWUPKR0MPOU8FGXBT394 （苹果股份有限公司）

特性

核心能力

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

财务标识符

• BIC/SWIFT查询：从BIC代码中查找银行LEI
• ISIN查询：从ISIN代码中查找安全发行人LEI
• 国家浏览：按管辖区列出实体

关系与合规

• 企业所有权：母公司、子公司、最终母公司
• 基金关系：基金经理、伞式基金、子基金
• 报告例外情况：2级数据异常及其原因
• LEI发行人：所有本地操作单元（LOU）的列表和详细信息

性能和可靠性

• 快速响应：结果在本地缓存，因此重复查询会立即返回
• 不需要API密钥：与GLEIF的公共API开箱即用
• 优雅地处理错误：超时或临时故障时自动重试
• 保持在限制范围内：内置的利率限制可防止达到GLEIF的配额

安装

下载二进制文件

上所有平台的预构建二进制文件 发布页面:

# 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代理设置

最快开始： 使用克劳德桌面？只需添加下面的配置并重新启动。使用像Cursor这样的IDE？相同的想法，不同的配置文件。选择下面的工具。

克劳德桌面版

第一步：下载二进制文件

去 发布页面 并为您的系统下载二进制文件：

• Mac（苹果硅M1/M2/M3/M4）： gleif-mcp-server-darwin-arm64
• Mac（英特尔）： gleif-mcp-server-darwin-amd64
• 窗户： 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：打开配置文件

雨衣： 打开查找器，按 Cmd + Shift + G，粘贴此路径：

~/Library/Application Support/Claude/

窗户： 按 Win + R，粘贴此路径：

%APPDATA%\Claude

打开 claude_desktop_config.json。如果它不存在，请创建它。

步骤4：添加配置

苹果电脑 （将YOUR_USERNAME替换为您的实际用户名）：

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

视窗 （替换YOUR_USERNAME-注意双反斜杠）：

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

要查找您的用户名：Mac-打开终端并键入 whoami.Windows-看看 C:\Users\.

步骤5：重新启动克劳德桌面

完全退出(Cmd + Q 在Mac上）并重新打开。

第六步：测试

键入克劳德桌面：

Look up Apple's LEI using GLEIF

您应该看到Claude调用GLEIF工具并返回公司数据。

克劳德代码（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

光标IDE

添加 .cursor/mcp.json 在您的项目或 ~/.cursor/mcp.json 对于全局配置：

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

带有Continue扩展名的VS代码

添加 .continue/config.json:

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

帆板运动

添加 ~/.codeium/windsurf/mcp_config.json:

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

Cline（VS代码扩展）

通过Cline的MCP设置或 .vscode/cline_mcp_settings.json:

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

反重力

添加 ~/.antigravity/mcp.json:

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

不工作？ 告诉我们是什么让事情变得困难 --即使是一句话也有帮助。

工具参考

核心查找工具

搜索工具

关系工具

LEI发卡机构工具

合规工具

用法示例

基本LEI查找

提示： “查找雷HWUPKR0MPOU8FGXBT394”

退货： 苹果股份有限公司的完整实体详细信息，包括法定名称、总部地址、司法管辖区（US-CA）、实体状态、注册状态、管理LOU和下一次续约日期。

使用分页功能搜索公司

提示： “搜索德意志银行，显示第2页”

工具调用：

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

退货： 具有分页信息的匹配实体列表（总结果，当前页面，有更多）。

批量LEI查找

提示： “查找这些LEI：HWUPKR0MPOU8FGXBT394、5493006MHB84DD0ZWV18、549300GKFG0RYRRQ1414”

退货： 包含LEI、法定名称、国家、城市和状态的所有三个实体的摘要。

通过BIC查找银行

提示： “查找BIC DEUTDEFF的LEI”

退货： 德意志银行的LEI记录及其全部细节。

查找安全发行人

提示： “谁发布了ISIN US0378331005？”

退货： 苹果股份有限公司（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
}

错误处理

服务器返回结构化错误：

错误响应示例：

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

技术细节

对于想要了解细节的开发人员：

API 参考

此服务器包装公共GLEIF API：

• 基础网址: 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 .

贡献

欢迎捐款。请先打开一个问题来讨论拟议的更改。

许可证

MIT许可证-请参阅 许可证 了解详情。

更多MCP服务器

查看我的其他MCP服务器：

______________________________________________________________________

致谢

• GLEIF 用于公共LEI API
• 模型上下文协议 对于MCP规范