AI导哈

增值税验证服务

VIES MCP Server 是一个用于验证欧盟增值税号（VAT ID）的服务，通过官方VIES系统提供实时验证和公司信息检索，适用于企业自动化流程和合规管理。

  • by vzeman
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 vzeman/vies-mcp-server

使用说明

VIES MCP服务器

一种模型上下文协议（MCP）服务器，用于使用VIES（增值税信息交换系统）服务验证欧盟增值税ID。

自定义MCP服务器开发

我们为客户开发定制的MCP服务器。如果您的系统需要与此MCP服务器类似的MCP服务器，请联系我们(https://www.flowhunt.io/contact/). 详细了解我们如何为客户开发MCP服务器：https://www.flowhunt.io/services/mcp-server-development/

演示

为什么将增值税ID验证作为LLM工具？

将增值税ID验证集成为LLM工具为业务自动化提供了显著优势：

实时数据准确性

  • 实时验证：LLM可以根据欧盟官方数据库实时验证增值税ID，确保数据准确性
  • 公司详细信息：自动检索官方公司名称和地址，减少手动数据输入错误
  • 合规性保证：在处理交易或创建记录之前，确保增值税ID有效

业务流程自动化

  • ERP集成：当连接Odoo、SAP或其他ERP平台等系统时，LLM可以自动：

    • 在创建新联系人或客户之前验证增值税ID
    • 从官方来源自动填充公司信息
    • 标记无效或过期的增值税号码以供审查

  • 发票处理：在发票处理工作流中自动验证供应商增值税ID

  • 客户入职培训：通过验证企业客户的增值税信息简化KYC/KYB流程

智能决策

  • 上下文感知验证：LLM可以根据对话上下文理解何时需要进行增值税验证
  • 错误处理：验证失败时提供有意义的解释（例如，格式不正确、编号过期）
  • 跨境交易：帮助根据已验证的增值税状态确定正确的税务处理

示例用例

  1. 自动创建联系人：“使用增值税ID DE123456789在Odoo中创建新客户”-LLM在创建联系人之前验证增值税ID并检索官方公司详细信息
  2. 批量导入验证：处理客户数据的电子表格，在导入前验证所有增值税ID
  3. 合规报告：生成所有增值税ID无效或缺失的客户的报告
  4. 智能表单：构建会话界面，在用户提供增值税ID时对其进行验证

特性

  • 通过官方VIES REST API验证欧盟增值税ID
  • 获取可用的公司信息（名称和地址）
  • 列出所有受支持的欧盟国家
  • 使用Python和MCP SDK构建

安装

# Clone the repository
git clone https://github.com/yourusername/vies-mcp-server.git
cd vies-mcp-server

# Install the package
pip install -e .

用法

运行服务器

服务器可以直接运行：

python -m vies_mcp_server

或者使用已安装的脚本：

vies-mcp-server

可用工具

  1. validate_vat：验证欧盟增值税ID

    • 输入： vat_id （string）-要验证的增值税ID（例如，“DE123456789”）
    • 返回：验证结果，包括有效性状态、公司名称和地址（如果可用）

  2. 获取_个国家：获取支持VIES增值税验证的欧盟国家列表

    • 无需输入
    • 返回：国家代码和名称列表

与Claude Desktop集成

将以下内容添加到您的Claude Desktop配置中：

{
  "mcpServers": {
    "vies": {
      "command": "/path/to/vies-mcp-server/venv/bin/python",
      "args": ["-m", "vies_mcp_server"],
      "cwd": "/path/to/vies-mcp-server"
    }
  }
}

示例用法

一旦与MCP客户端集成，您可以：

  1. 验证德国增值税ID：

    validate_vat("DE123456789")

  2. 获取支持的国家列表：

    get_eu_countries()

支持的国家

服务器支持所有欧盟成员国的增值税验证：

  • AT（奥地利）
  • BE（比利时）
  • BG（保加利亚）
  • CY（塞浦路斯）
  • CZ（捷克共和国）
  • DE（德国）
  • DK（丹麦）
  • EE（爱沙尼亚）
  • EL（希腊）
  • ES（西班牙）
  • FI（芬兰）
  • FR（法国）
  • HR（克罗地亚）
  • 胡（匈牙利）
  • IE（爱尔兰）
  • IT（意大利）
  • LT（立陶宛）
  • LU（卢森堡）
  • LV（拉脱维亚）
  • MT（马耳他）
  • NL(荷兰)
  • PL（波兰）
  • PT（葡萄牙）
  • RO（罗马尼亚）
  • SE（瑞典）
  • SI（斯洛文尼亚）
  • SK（斯洛伐克）

api参考

服务器使用官方的欧盟VIES REST API：

  • 基本URL:https://ec.europa.eu/taxation_customs/vies/rest-api/
  • 文档：https://ec.europa.eu/taxation_customs/vies/#/vat-验证

错误处理

服务器处理各种错误情况：

  • 国家代码无效
  • 增值税号码格式无效
  • 网络超时
  • API错误
  • 无效响应

所有错误都会返回描述性消息，以帮助诊断问题。

发展

需求

  • Python 3.9+
  • MCP-SDK
  • httpx

运行测试

# Install dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

许可证

MIT许可证

贡献

欢迎投稿！请随时提交拉取请求。

相关 MCP