Vatnode

vatnode-mcp

vatnode 官方的 Model Context Protocol 服务——为 AI Agent 提供 VAT 验证和欧盟税务数据。

让 AI 助手（Claude Desktop、Cursor、ChatGPT、Continue、Cline 等）在聊天中查询 VAT 税率、检查 VAT 号码格式，以及通过欧盟 VIES 服务验证 VAT ID。

• 免费、离线——支持 45 个欧洲国家的 VAT 税率和格式检查，无需账户
• 实时验证——通过 VIES 验证欧盟 VAT 号码，获取注册公司信息和 VIES 查询编号（需要免费的 vatnode API 密钥；在控制面板的 Account details 中设置自己的 VAT 作为请求方后，即可生成查询编号）
• 五款专用工具——描述清晰，便于 Agent 准确选择工具
• 纯 stdio，无托管依赖，通过 npx 在本地运行

---

工具

工具	免费	说明
get_country_vat_rates	✅	某个国家的标准税率 / 优惠税率 / 超优惠税率 / 停车税率，以及 VAT 号码格式
list_eu_vat_rates	✅	一次列出全部 27 个欧盟成员国（另含北爱尔兰 XI）的 VAT 税率
check_vat_format	✅	离线检查 VAT 号码是否符合相应国家的正则表达式格式
list_supported_countries	✅	列出全部 45 个支持的国家，以及哪些国家支持完整的 VIES 验证
validate_vat_number	🔑	实时 VIES 验证——返回有效性、公司名称、地址、注册日期，以及（在控制面板的 Account details 中设置请求方 VAT 后）VIES 查询编号

免费工具完全离线运行——数据通过 eu-vat-rates-data 打包，并从欧盟委员会 TEDB 每日更新。

validate_vat_number 需要 vatnode API 密钥。免费套餐包含每月请求额度——30 秒即可获取。

---

安装

Claude Desktop

添加到 claude_desktop_config.json（macOS：~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "vatnode": {
      "command": "npx",
      "args": ["-y", "vatnode-mcp"],
      "env": {
        "VATNODE_API_KEY": "vat_live_your_key_here"
      }
    }
  }
}

重启 Claude Desktop。工具选择器中将显示 vatnode 工具。

如果只需要免费工具（税率、格式检查），可以省略 VATNODE_API_KEY。

Cursor

设置 → MCP → 添加新服务：

{
  "mcpServers": {
    "vatnode": {
      "command": "npx",
      "args": ["-y", "vatnode-mcp"],
      "env": { "VATNODE_API_KEY": "vat_live_your_key_here" }
    }
  }
}

ChatGPT（自定义连接器 / Apps SDK）

将其配置为 stdio MCP 服务，并使用相同的 npx -y vatnode-mcp 命令。请参阅 Apps SDK 文档。

Continue / Cline / 其他客户端

任何兼容 MCP 的客户端都可以连接——将其指向 npx -y vatnode-mcp，并可选择通过环境变量传入 VATNODE_API_KEY。

---

获取 API 密钥

validate_vat_number 需要 vatnode 账户。该平台还提供 MCP 未公开的功能：

• VAT 状态变更 Webhook（持续监控客户的 VAT 状态）
• 批量验证
• VIES 故障时回退到国家数据库
• VIES 查询编号（带时间戳的记录，证明已向 VIES 发起查询）
• 按密钥进行速率限制 + 控制面板分析

免费注册 →

---

示例会话

你： 芬兰和德国的增值税税率是多少？

（Agent 为 FI 和 DE 调用 get_country_vat_rates——免费，无需密钥。）

Agent： 芬兰的标准增值税税率为 25.5%，德国为 19%。芬兰还有 14% 和 10% 的优惠税率；德国为 7%。

你： IE6388047V 是有效的增值税号吗？

（Agent 调用 validate_vat_number——需要 API 密钥。）

Agent： 是，有效。注册主体为 GOOGLE IRELAND LIMITED，地址为 Gordon House, Barrow Street, Dublin 4。

---

配置

环境变量	必需	默认值	用途
VATNODE_API_KEY	用于 validate_vat_number	—	从 https://vatnode.dev 获取的 API 密钥
VATNODE_API_URL	否	https://api.vatnode.dev	覆盖 API 基础 URL（自托管／暂存环境）

---

参与贡献

欢迎提交错误报告和 PR。对于较大的更改，请先提出 issue，以便我们就方向达成一致。

git clone https://github.com/vatnode/vatnode-mcp.git
cd vatnode-mcp
npm install
npm test

发布

版本通过 Trusted Publishing 发布到 npm——无需 NPM_TOKEN 密钥，每次发布都会通过 npm provenance 签名。

# bump the version in ALL of: package.json, src/index.ts (VERSION),
# and server.json (top-level "version" + packages[0].version — the MCP
# Registry publish reads server.json and rejects a duplicate version).
# Commit, then:
git tag v0.3.2
git push --tags

.github/workflows/release.yml 中的 CI 会检测标签并发布。

许可证

MIT