Veille

Veille MCP サーバー

Veille の不正防止 API に対応する、公式の Model Context Protocol サーバーです。

メールアドレス、ドメイン、IP、VAT 番号、IBAN を数ミリ秒で検証し、偽のサインアップ、ボット、不正行為を防止します。

Claude、Cursor、VS Code、Windsurf など、あらゆる MCP クライアントから API をツールとして呼び出せます。stdio（ローカル）または Streamable HTTP（セルフホスト可能）で動作します。

要件

• Node.js 20 以降
• Veille API キー — 登録してから、ダッシュボードでキーをコピーしてください

ホスト型サーバー（推奨）

Veille が https://mcp.veille.io/（Streamable HTTP）でこのサーバーを実行します。API キーを x-api-key ヘッダーに設定して送信してください。インストールは不要です。

claude mcp add --transport http veille https://mcp.veille.io/ --header "x-api-key: YOUR_API_KEY"

{
  "mcpServers": {
    "veille": {
      "url": "https://mcp.veille.io/",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

ホスト型サーバーとこのパッケージが公開する API は同じです。stdio を使う場合、ご自身のネットワークから外部へ接続する場合、またはセルフホストする場合は、パッケージをローカルで実行してください。

ローカルで実行する

Claude Code

claude mcp add veille --env VEILLE_API_KEY=YOUR_API_KEY -- npx -y @veilleio/mcp

Claude Desktop、Cursor、Windsurf、その他のクライアント

クライアントの MCP 設定（claude_desktop_config.json、.cursor/mcp.json など）にサーバーを追加します。

{
  "mcpServers": {
    "veille": {
      "command": "npx",
      "args": ["-y", "@veilleio/mcp"],
      "env": {
        "VEILLE_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

VS Code

{
  "servers": {
    "veille": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@veilleio/mcp"],
      "env": {
        "VEILLE_API_KEY": "${input:veille-api-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "veille-api-key",
      "description": "Veille API key",
      "password": true
    }
  ]
}

Claude Desktop 拡張機能

リリースページから .mcpb バンドルをダウンロードして開きます。Claude Desktop で API キーを求められます。

Docker

docker build -t veille-mcp .
docker run -i --rm -e VEILLE_API_KEY=YOUR_API_KEY veille-mcp

ツール

ツール	説明
intelligence_domain	任意のドメインを即座にチェックします。使い捨てメールプロバイダー、一般向けウェブメール、リレーサービス、教育機関のドメインを検出します。MX プロバイダーの検出を含む DNS の健全性、ドメインの履歴、任意の SSL/… を返します
intelligence_email	1 回の呼び出しで任意のメールアドレスを検証します。使い捨ておよび一時的な受信箱を検出し、役割アカウント、一般向けウェブメール、リレーサービスを特定して、0〜100 のリスクスコアを返します。詳細な配信可能性については…
intelligence_emailq	メールの配信可能性を詳細に検証します。完全なメール検証に加えて、SMTP 受信箱チェックとキャッチオール検出を実行し、判定結果（有効、無効、リスクあり、使い捨て、不明）を返します。
intelligence_ip	任意の IP アドレスのレピュテーションを評価します。VPN、プロキシ、Tor の出口ノード、データセンターのホスティング、悪意のあるトラフィック、ボットを検出します。位置情報、ネットワーク所有者、0〜100 の脅威スコアを返します。
intelligence_phone	E.164 形式の任意の電話番号を検証します。使い捨て番号および仮想番号を検出し、通信事業者と回線種別（携帯電話／固定電話／VoIP）を特定して、国とタイムゾーンを返し、0〜100 のリスクスコアを算出します。
stats	過去 1 時間におけるエンジンまたはエンドポイントのインフラストラクチャの健全性を確認します。アカウントやテナント単位ではありません。アカウントごとに有効化されます。HTTP 403 が返された場合は、サポートに連絡して有効化してください。
usage	Veille アカウントのリアルタイムの使用状況統計とクレジット残高を取得します。
vat	VIES データベースを照合して、欧州の VAT 番号を検証します。EU 加盟国の任意の国について、会社名、登録住所、有効性ステータスを返します。
vat_iban	任意の IBAN を検証し、関連する銀行情報を取得します。BIC/SWIFT コード、銀行名、国、BBAN の構造内訳、SEPA ゾーンへの所属を返します。
vat_rates	対応する任意の基準通貨について、最新の ECB 為替レートを取得します。特定の換算先通貨に絞り込むこともできます。欧州中央銀行のデータに基づき、毎日更新されます。

API を呼び出すツールはすべてクレジットを消費します。JSON の結果はテキストとして返され、画像はインラインで返されます。その他のファイル（PDF など）は、最大 4 MB まで埋め込みリソースとして返されます。

Streamable HTTP

npx @veilleio/mcp --http --port 3000

エンドポイントは POST /mcp（ステートレス、JSON レスポンス）です。各クライアントは x-api-key ヘッダー（または Authorization: Bearer <key>）で自身のキーを送信します。サーバーが独自のキーを使用することはありません。デフォルトでは 127.0.0.1 にバインドされ、許可されていないブラウザーのオリジンからのリクエストは拒否されます。外部に公開する前に、TLS の背後に配置してください。

createHttpHandler() は、Fetch 互換のランタイム（Cloudflare Workers、Deno、Bun）向けにエクスポートされています。

import { createHttpHandler } from "@veilleio/mcp";

export default { fetch: createHttpHandler({ allowedOrigins: [] }) };

セキュリティ

• API キーは VEILLE_API_KEY（stdio）またはリクエストヘッダー（HTTP）から読み込まれ、エラーメッセージからは削除されます。
• ウェブサイトから取得したコンテンツは信頼できないものとして扱われます。サーバーの指示では、モデルに対し、これを指示ではなくデータとして扱うよう伝えます。
• 脆弱性の報告については、SECURITY.md を参照してください。

開発

npm install
npm test
npm run build
npx @modelcontextprotocol/inspector node dist/stdio.js

SDK を基盤として構築

このサーバーは公式の Node.js SDK（@veilleio/sdk）を使用しています。

Veille SDK一覧

SDK	パッケージ	インストール
Node.js	@veilleio/sdk	npm install @veilleio/sdk
Python	veille	pip install veille
Go	veille-go	go get github.com/veilleio/veille-go
.NET	Veille	dotnet add package Veille
Ruby	veille	gem install veille
PHP	veille/sdk	composer require veille/sdk
Java	veille-java	ソースからビルドしてください。READMEを参照してください
CLI	@veilleio/cli	npm install -g @veilleio/cli
MCP サーバー	@veilleio/mcp	npx -y @veilleio/mcp

ライセンス

MIT — LICENSEを参照してください。