eurovalidate-mcp

EuroValidate MCP 服务

面向 EuroValidate 的 MCP（Model Context Protocol）服务——让 Claude、ChatGPT 和任何兼容 MCP 的 Agent 都能通过一个可靠的 REST API，验证欧盟 VAT 号码（VIES）、IBAN 和 EORI 海关号码，查询公司数据，并获取 VAT 税率。

为什么选择它

验证欧洲企业数据通常意味着要应付五个彼此分散的政府服务：VIES SOAP API（经常超时——仅德国就占其错误的 95%）、EC EORI 端点、HMRC、GLEIF 和各国注册机构。EuroValidate 将它们整合为一个以缓存优先的 JSON API，并提供按国家/地区划分的熔断器和优雅降级——这个 MCP 服务则将其作为可直接使用的工具提供给大模型 Agent。

工具

工具	功能
validate_vat	通过 VIES/HMRC 验证欧盟/英国 VAT 号码——返回有效性、注册公司名称和地址（如果成员国提供）以及置信度
validate_iban	验证 IBAN（离线 MOD-97），并解析银行名称和 BIC
validate_eori	验证 EORI 海关号码（欧盟 / GB / XI 北爱尔兰）
lookup_company_by_lei	按法人机构识别码查询公司数据（GLEIF）
lookup_company_by_vat	按 VAT 号码查询公司数据——在 VIES 不显示名称的 DE/ES 作为后备方案
get_vat_rates	查询欧盟国家/地区当前的 VAT 税率
check_service_status	实时检查 VIES（按国家/地区）、EORI、HMRC 和 GLEIF 的运行状况——无需 API 密钥

设置

1. 在 eurovalidate.com 获取免费 API 密钥（每月 100 次请求，无需信用卡）。
2. 将此服务添加到你的 MCP 客户端：

Claude Desktop / Claude Code

{
  "mcpServers": {
    "eurovalidate": {
      "command": "uvx",
      "args": ["eurovalidate-mcp"],
      "env": { "EUROVALIDATE_API_KEY": "your_api_key" }
    }
  }
}

Claude Code 单行命令：

claude mcp add eurovalidate -e EUROVALIDATE_API_KEY=your_api_key -- uvx eurovalidate-mcp

任何其他 MCP 客户端

通过 stdio 运行：

EUROVALIDATE_API_KEY=your_api_key uvx eurovalidate-mcp

或者永久安装：pip install eurovalidate-mcp → eurovalidate-mcp。

示例提示词

• “验证 VAT 号码 DE811569869，并告诉我对应的公司”
• “检查这个 IBAN 是否有效，以及它属于哪家银行：DE89 3704 0044 0532 0130 00”
• “德国的 VIES 现在宕机了吗？”
• “葡萄牙的 VAT 税率是多少？”
• “在我向这些供应商开票之前，先验证这 5 个供应商的 VAT 号码”

给 Agent（和用户）的说明

• 德国和西班牙不会通过 VIES 返回公司名称/地址（数据保护法所致）——请使用 lookup_company_by_vat 作为后备方案。
• 希腊在 VIES 中使用 EL，但在 ISO 3166 中使用 GR——两者均可接受。
• 每个响应都包含 confidence: HIGH|MEDIUM|LOW|UNKNOWN 和上游 source，因此当政府服务宕机时，Agent 可以据此判断数据的新鲜度。
• 免费套餐：每月 100 次请求。付费套餐起价为每月 €19（每月 500,000 次请求），详见 eurovalidate.com。

Agent 技能

skills/eu-business-validation/SKILL.md 是一项可移植的 Agent Skill，用于教会 Agent 何时进行验证、如何正确解读 status/confidence（例如，unavailable ≠ invalid）、DE/ES/EL/XI 的注意事项，以及如何编写在 VIES 宕机时也绝不会阻止销售的结账/KYB 代码。它可与此 MCP 服务配合使用，也可回退到普通 REST 调用。

# Claude Code (personal skills)
mkdir -p ~/.claude/skills && cp -r skills/eu-business-validation ~/.claude/skills/

Claude 插件

此仓库也是一个 Claude 插件包（.claude-plugin/plugin.json）：它会安装上述技能以及此 MCP 服务，固定使用 eurovalidate-mcp==0.1.1 并通过 uvx 启动。安装时，系统会提示你输入 EuroValidate API 密钥；该密钥会存储在 Claude 的安全凭据存储中，并且只会作为 EUROVALIDATE_API_KEY 传递给 MCP 服务。

数据与网络

• MCP 服务和技能只会将你要求检查的标识符（VAT、IBAN、EORI、LEI 编号或国家代码）发送到 https://api.eurovalidate.com，并在 X-API-Key 标头中附上你的 API 密钥。check_service_status 不会发送任何标识符，也不需要密钥。
• 不会读取你设备上的其他内容，也不会将任何内容发送到其他地方。不会进行遥测。
• EuroValidate 随后会查询公共政府服务（EU VIES、EC EORI、UK HMRC、GLEIF），并缓存结果（VAT/EORI 缓存 24 h，IBAN 缓存 1 h）。请参阅隐私政策和条款。
• uvx 首次运行时，会从 PyPI 下载 eurovalidate-mcp 软件包。

环境变量

变量	必填	默认值
EUROVALIDATE_API_KEY	是（check_service_status 除外）	—
EUROVALIDATE_BASE_URL	否	https://api.eurovalidate.com

许可证

MIT

---

mcp-name: io.github.Nitrych/eurovalidate-mcp