内容
# vatnode-mcp
[](https://www.npmjs.com/package/vatnode-mcp)
[](https://github.com/vatnode/vatnode-mcp/actions/workflows/test.yml)
[](LICENSE)
[](https://glama.ai/mcp/servers/vatnode/vatnode-mcp)
官方 [模型上下文协议](https://modelcontextprotocol.io) 服务器，为 **[vatnode](https://vatnode.dev)** — 增值税验证和欧盟税务数据适用于 AI 代理。
让 AI 助手（Claude Desktop, Cursor, ChatGPT, Continue, Cline, …）查询增值税率，检查增值税编号格式，并验证增值税编号是否符合欧盟 VIES 服务，而无需离开聊天。
- **免费，离线** — 45个欧洲国家的增值税率和格式检查，无需账户
- **实时验证** — 验证欧盟增值税编号是否符合 VIES，获取注册公司 + 审计级咨询编号（需要免费的 [vatnode](https://vatnode.dev) API 密钥）
- **五种专注工具** — 精确描述以确保准确的代理工具选择
- 纯粹的标准输入/输出，零托管依赖，通过 `npx` 本地运行
---
## 工具
| 工具 | 免费 | 描述 |
|---|---|---|
| `get_country_vat_rates` | ✅ | 某个国家的标准 / 减税 / 超减税 / 停车费率 + 增值税编号格式 |
| `list_eu_vat_rates` | ✅ | 所有27个欧盟成员国（以及XI北爱尔兰）一次 |
| `check_vat_format` | ✅ | 增值税编号的离线语法检查是否符合国家正则表达式 |
| `list_supported_countries` | ✅ | 所有45个支持的国家以及哪些国家支持完整的VIES验证 |
| `validate_vat_number` | 🔑 |实时VIES验证 — 返回有效性，公司名称，地址，注册日期和可选的审计证明咨询编号 |
免费工具完全离线 — 数据通过 [`eu-vat-rates-data`](https://www.npmjs.com/package/eu-vat-rates-data) 捆绑并每天从欧洲委员会TEDB更新。
`validate_vat_number` 需要一个 vatnode API 密钥。免费层包括每月请求配额 — [30秒内获取一个](https://vatnode.dev)。
---
## 安装
### Claude Desktop
添加到您的 `claude_desktop_config.json` （macOS：`~/Library/Application Support/Claude/claude_desktop_config.json`）：
```json
{
"mcpServers": {
"vatnode": {
"command": "npx",
"args": ["-y", "vatnode-mcp"],
"env": {
"VATNODE_API_KEY": "vat_live_..."
}
}
}
}
```
重启Claude Desktop。`vatnode` 工具将出现在工具选择器中。
如果您只需要免费工具（费率，格式检查），可以省略 `VATNODE_API_KEY`。
### Cursor
设置 → MCP → 添加新服务器：
```json
{
"mcpServers": {
"vatnode": {
"command": "npx",
"args": ["-y", "vatnode-mcp"],
"env": { "VATNODE_API_KEY": "vat_live_..." }
}
}
}
```
### ChatGPT（自定义连接器 / 应用SDK）
配置为_stdio_MCP服务器，命令相同`npx -y vatnode-mcp`。请参阅 [应用SDK文档](https://platform.openai.com/docs)。
### Continue / Cline / 其他客户端
任何MCP兼容的客户端都可以连接 — 指向 `npx -y vatnode-mcp` 并（可选）通过环境传递 `VATNODE_API_KEY`。
---
## 获取API密钥
`validate_vat_number` 需要一个 [vatnode](https://vatnode.dev) 账户。该平台还提供MCP未公开的内容：
- 增值税状态变更的网络钩子（持续监控客户的增值税）
- 批量验证
- VIES宕机时的国家数据库备用
- VIES咨询编号（审计级验证证明）
- 按密钥限制速率 + 仪表板分析
[**免费注册 →**](https://vatnode.dev)
---
## 示例会话
> **您：** 芬兰和德国的增值税率是多少？
>
> *(代理调用 `get_country_vat_rates` 获取FI和DE — 免费，无需密钥。)*
>
> **代理：** 芬兰的标准增值税率为25.5%，德国的标准增值税率为19%。芬兰有14%和10%的减税率；德国有7%的减税率。
> **您：** IE6388047V 是否有效增值税？
>
> *(代理调用 `validate_vat_number` — 需要API密钥。)*
>
> **代理：** 是的，它有效。注册给 **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基础（自托管 / 预发布） |
---
## 贡献
欢迎提交错误报告和PR。对于非琐碎的更改，请先打开一个问题，以便我们统一方向。
```bash
git clone https://github.com/vatnode/vatnode-mcp.git
cd vatnode-mcp
npm install
npm test
```
## 发布
版本发布到npm，通过 [Trusted Publishing](https://docs.npmjs.com/trusted-publishers) — 无需NPM_TOKEN密钥，每个版本都使用 [npm provenance](https://docs.npmjs.com/generating-provenance-statements) 签名。
```bash
# 在 package.json 中升级版本号（和 src/index.ts 中的 VERSION），提交，然后：
git tag v0.2.1
git push --tags
```
CI 在 `.github/workflows/release.yml` 上获取标签并发布。
## 许可证
MIT
