vatnode-mcp 是 vatnode 官方推出的 Model Context Protocol（MCP）服务器，面向 AI 智能体提供欧盟增值税（VAT）相关的查询与验证能力。它允许 AI 助手（如 Claude Desktop、Cursor、ChatGPT、Continue、Cline 等）在不离开聊天界面的情况下，查询 VAT 税率、检查 VAT 号码格式，并针对欧盟 VIES 服务验证 VAT 号码。
主要能力
- 免费、离线：内置 45 个欧洲国家的 VAT 税率与格式检查数据，无需账号即可使用。数据通过 eu-vat-rates-data 打包，并每日从欧盟委员会 TEDB 更新。
- 实时验证：可针对 VIES 验证欧盟 VAT 号码，获取注册公司信息以及 VIES 咨询编号（consultation number）。此功能需要免费的 vatnode API 密钥；咨询编号需在仪表盘设置中将自身 VAT 设为请求方后生成。
- 五个专注工具：工具描述清晰，便于智能体准确选择。
- 纯 stdio、零托管依赖：通过 npx 在本地运行。
使用方式 在 Claude Desktop 中，将服务器添加到 claude_desktop_config.json（macOS 路径：~/Library/Application Support/Claude/claude_desktop_config.json），然后重启 Claude Desktop，vatnode 工具将出现在工具选择器中。如果只需要免费工具（税率、格式检查），可以省略 VATNODE_API_KEY。 在 Cursor 中，通过 Settings → MCP → Add new server 添加。 在 ChatGPT（自定义连接器 / Apps SDK）中，配置为 stdio MCP 服务器，使用相同的 npx -y vatnode-mcp 命令。 Continue / Cline / 其他客户端：任何兼容 MCP 的客户端均可连接，指向 npx -y vatnode-mcp，并可选通过环境变量传入 VATNODE_API_KEY。
适用场景
- 在对话中快速查询欧洲国家 VAT 税率。
- 检查 VAT 号码格式是否符合规范。
- 验证欧盟 VAT 号码并获取注册公司信息。
限制与说明
- validate_vat_number 需要 vatnode 账号与 API 密钥；免费套餐包含每月请求配额。
- 平台还提供 MCP 未暴露的功能：VAT 状态变更 Webhook、批量验证、VIES 宕机时的国家数据库回退、VIES 咨询编号、按密钥限流与仪表盘分析。
- 免费工具完全离线，数据每日更新。
- 发布通过 npm Trusted Publishing 进行，每次发布均使用 npm provenance 签名。
示例会话 用户：芬兰和德国的 VAT 税率是多少？ （智能体调用 get_country_vat_rates 查询 FI 和 DE——免费，无需密钥。） 智能体：芬兰标准 VAT 税率为 25.5%，德国为 19%。芬兰有 14% 和 10% 的优惠税率；德国有 7%。 用户：IE6388047V 是有效的 VAT 吗？ （智能体调用 validate_vat_number——需要 API 密钥。） 智能体：是的，有效。注册公司为 GOOGLE IRELAND LIMITED，地址 Gordon House, Barrow Street, Dublin 4。
欢迎提交错误报告和 PR。对于非平凡变更，请先开 issue 以便对齐方向。
