根据全局信息，翻译目标语言为中文，且“API”必须保留为“API”。原文内容为“🇪🇺 VAT Validation API & MCP Server”，因此，翻译结果为：欧洲增值税验证API & MCP服务器
](https://github.com/jazib/check-vat-vies-mcp/actions/workflows/docker-publish.yml)  
为欧盟企业提供完整的增值税验证解决方案 - 集成n8n的REST API服务器，支持Claude Desktop的MCP。
🚀 快速部署选项
部署到Coolify
使用Docker进行部署
docker run -p 3000:3000 ghcr.io/jazib/check-vat-vies-mcp:latest部署到铁路（系统/网络）
部署到Render
✨ 特点
- 🔍 翻译为中文是：🔍（这个符号本身没有直接的中文翻译，它通常表示“查找”或“放大镜”的意思，在网络或应用中常用来表示搜索功能。） 实时增值税验证 - 使用官方VIES服务验证欧盟增值税号
- 🤖 机器人 REST API（Representational State Transfer Application Programming Interface，表述性状态传递应用程序编程接口） - 简单的HTTP端点，便于轻松集成
- 🔗 n8n 准备就绪 - 预构建的工作流和示例
- 🖥️（电脑/显示器） MCP 服务器 - Claude Desktop 集成用于 AI 驱动的验证
- 🐳 表示海豚或水瓶的图案，常用于表情符号中表达可爱、活泼或与水相关的意象。 Docker 支持 - 准备就绪的生产级容器化
- 🌍（地球） 所有欧盟国家 - 支持所有27个欧盟成员国
- ⚡（闪电符号，无直接对应中文含义，可保留原样或根据上下文解释为“闪电”等） 自动检测 - 自动从增值税号中提取国家代码
- 📊（图表/数据表） 健康监测 - 内置健康检查和状态端点
📦 安装
选项1：运行API服务器
# Clone the repository
git clone https://github.com/jazib/check-vat-vies-mcp.git
cd check-vat-vies-mcp
# Install dependencies
npm install
# Build TypeScript
npm run build
# Start the API server
node api-server.js选项2：Docker
# Using Docker Compose
docker-compose up
# Or build and run manually
docker build -f Dockerfile.api -t vat-api .
docker run -p 3000:3000 vat-api选项3：使用预构建的Docker镜像
docker run -p 3000:3000 ghcr.io/jazib/check-vat-vies-mcp:latest🔌 API 端点
| 端点 | 方法 | 描述 |
|---|---|---|
/health | GET | 健康检查 |
/api/member-states | GET | 列出所有欧盟国家 |
/api/validate | POST | 使用国家代码+号码进行验证 |
/api/validate/auto | POST | 自动检测和验证 |
/api/status | GET | 检查VIES服务状态 |
示例请求
curl -X POST http://localhost:3000/api/validate/auto \
-H "Content-Type: application/json" \
-d '{"vat":"DE215891388"}'示例回复
{
"success": true,
"input": "DE215891388",
"processed": {
"countryCode": "DE",
"vatNumber": "215891388"
},
"data": {
"countryCode": "DE",
"vatNumber": "215891388",
"isValid": true,
"requestDate": "2025-09-26T18:00:00.000Z",
"companyName": "Example GmbH",
"companyAddress": "Berlin, Germany"
}
}🔧 n8n 集成
即用型n8n工作流，适用于：
- 单一增值税验证
- 从Google表格进行批处理
- CRM与Webhooks的集成
- 计划进行VIES状态监控
见 N8N工作流.md 以获取完整示例。
🤖 MCP 服务器（Claude 桌面版）
在您的Claude桌面配置中添加：
{
"mcpServers": {
"vies-vat-checker": {
"command": "node",
"args": ["/path/to/check-vat-vies-mcp/dist/index.js"],
"env": {},
"description": "EU VAT validation"
}
}
}🌍 支持的国家
欧盟全部27个成员国： AT BE BG CY CZ DE DK EE EL ES FI FR HR HU IE IT LT LU LV MT NL PL PT RO SE SI SK
🔒 环境变量
PORT=3000 # API server port
NODE_ENV=production # Node environment
RATE_LIMIT=60 # Requests per minute (optional)
ALLOWED_ORIGINS=* # CORS configuration (optional)
API_KEY=secret # API authentication (optional)📚 文档
- API 文档 - 完整的API参考
- Coolify 部署 - 部署到Coolify指南
- n8n 工作流 - 集成示例
- 贡献 - 如何做出贡献
🧪 开发
# Run in development mode
npm run dev
# Run tests
npm test
# Lint code
npm run lint
# Build TypeScript
npm run build🐳 Docker Hub（中文可译为“Docker 中心”或保持原名，因其为专有名词）
Docker 镜像会自动构建并发布到 GitHub 容器注册表：
docker pull ghcr.io/jazib/check-vat-vies-mcp:latest📄 许可证
MIT - 查看 许可证 文件
🤝 贡献（或“参与贡献”）
欢迎投稿！请阅读 \CONTRIBUTING.md\ 翻译为中文是：“贡献指南.md” 或 “贡献规范.md”（具体翻译可能根据上下文有所调整，但通常表示这是一个关于如何为项目做贡献的指南或规范文件） 第一。
🐛 问题
发现了一个漏洞？ 在此报告
⭐ 支持
如果你觉得这个项目有用，请给它点个星吧！
______________________________________________________________________
为欧盟商业界用心打造