eurovalidate-mcp

EuroValidate MCP サーバー

EuroValidate 用の MCP（Model Context Protocol）サーバーです。Claude、ChatGPT、および MCP 対応のあらゆるエージェントから、信頼性の高い単一の REST API を通じて、EU VAT 番号（VIES）、IBAN、EORI 税関番号の検証、企業データの検索、VAT 税率の取得を行えます。

導入する理由

欧州の企業データを検証するには、通常、分断された5つの政府サービスを使い分ける必要があります。VIES SOAP API（頻繁にタイムアウトし、エラーの95％はドイツだけで発生します）、EC EORI エンドポイント、HMRC、GLEIF、各国の登記機関です。EuroValidate は、国ごとのサーキットブレーカーとグレースフルデグラデーションを備えた、キャッシュ優先の単一の JSON API にこれらをまとめます。この MCP サーバーにより、LLM エージェントはすぐに使えるツールとしてこれらの機能を利用できます。

ツール

ツール	機能
validate_vat	VIES/HMRC を通じて EU/UK の VAT 番号を検証します。有効性、登録企業名と住所（加盟国が公開している場合）、確度レベルを返します
validate_iban	IBAN を検証し（オフラインの MOD-97）、銀行名と BIC を特定します
validate_eori	EORI 税関番号（EU / GB / XI 北アイルランド）を検証します
lookup_company_by_lei	Legal Entity Identifier（GLEIF）で企業データを検索します
lookup_company_by_vat	VAT 番号で企業データを検索します。VIES が名称を公開しない DE/ES のフォールバックです
get_vat_rates	EU 加盟国の現在の VAT 税率を取得します
check_service_status	VIES（国別）、EORI、HMRC、GLEIF の稼働状況をリアルタイムで確認します。API キーは不要です

セットアップ

1. eurovalidate.com で無料の API キーを取得します（月100リクエスト、クレジットカード不要）。
2. MCP クライアントにサーバーを追加します。

Claude Desktop / Claude Code

{
  "mcpServers": {
    "eurovalidate": {
      "command": "uvx",
      "args": ["eurovalidate-mcp"],
      "env": { "EUROVALIDATE_API_KEY": "your_api_key" }
    }
  }
}

Claude Code のワンライナー：

claude mcp add eurovalidate -e EUROVALIDATE_API_KEY=your_api_key -- uvx eurovalidate-mcp

その他の MCP クライアント

stdio で実行します。

EUROVALIDATE_API_KEY=your_api_key uvx eurovalidate-mcp

または、恒久的にインストールします：pip install eurovalidate-mcp → eurovalidate-mcp。

プロンプト例

• 「VAT 番号 DE811569869 を検証して、その企業について教えてください」
• 「この IBAN が有効か、どの銀行のものか確認してください：DE89 3704 0044 0532 0130 00」
• 「今、ドイツで VIES がダウンしていますか？」
• 「ポルトガルの VAT 税率はいくらですか？」
• 「請求書を発行する前に、この5社の仕入先の VAT 番号を検証してください」

エージェント（および人間）向けの注意事項

• ドイツとスペインでは、VIES を通じて企業名や住所が返されることはありません（データ保護法による制限）。代わりに lookup_company_by_vat を使用してください。
• ギリシャは VIES では EL、ISO 3166 では GR です。どちらも使用できます。
• すべての応答には confidence: HIGH|MEDIUM|LOW|UNKNOWN と上流の source が含まれます。そのため、政府サービスが停止している場合でも、エージェントはデータの鮮度を判断できます。
• 無料プランは月100リクエストです。有料プランは月額 €19 から（月500,000リクエスト）、eurovalidate.com で利用できます。

エージェントスキル

skills/eu-business-validation/SKILL.md は、エージェントに検証を行うタイミング、status/confidence の正しい読み取り方（たとえば、unavailable は invalid を意味しません）、DE/ES/EL/XI の注意点、VIES が停止していても販売を決して妨げないチェックアウト/KYB コードの書き方を教える、持ち運び可能な Agent Skill です。この MCP サーバーと連携するほか、通常の REST 呼び出しにフォールバックすることもできます。

# Claude Code (personal skills)
mkdir -p ~/.claude/skills && cp -r skills/eu-business-validation ~/.claude/skills/

Claude プラグイン

このリポジトリは Claude プラグインバンドル（.claude-plugin/plugin.json）でもあります。上記のスキルと、この MCP サーバー（eurovalidate-mcp==0.1.1 に固定し、uvx で起動）をインストールします。インストール時に EuroValidate API キーの入力を求められます。キーは Claude の安全な認証情報ストアに保存され、EUROVALIDATE_API_KEY として MCP サーバーにのみ渡されます。

データとネットワーク

• MCP サーバーとスキルは、確認を依頼した識別子（VAT、IBAN、EORI、LEI 番号、または国コード）のみを、X-API-Key ヘッダーの API キーとともに https://api.eurovalidate.com に送信します。check_service_status は識別子を送信せず、キーも必要ありません。
• お使いのマシンからほかの情報を読み取ったり、ほかの場所に送信したりすることはありません。テレメトリーもありません。
• EuroValidate は、公開されている政府機関のサービス（EU VIES、EC EORI、UK HMRC、GLEIF）に問い合わせ、結果をキャッシュします（VAT/EORI は 24 時間、IBAN は 1 時間）。プライバシーポリシーと利用規約をご覧ください。
• 初回実行時に、uvx が PyPI から eurovalidate-mcp パッケージをダウンロードします。

環境変数

変数	必須	デフォルト
EUROVALIDATE_API_KEY	はい（check_service_status を除く）	—
EUROVALIDATE_BASE_URL	いいえ	https://api.eurovalidate.com

ライセンス

MIT

---

mcp-name: io.github.Nitrych/eurovalidate-mcp