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/

演示

VIES MCP Server Demo

为什么将增值税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”） - 返回：验证结果，包括有效性状态、公司名称和地址（如果可用）

1. 获取_个国家：获取支持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")

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

   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许可证

贡献

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