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）为你运行此服务。只需在 x-api-key 标头中发送 API 密钥；无需安装。

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	即时检查任意域名。检测一次性邮箱服务商、公共 Webmail、邮件中继服务和教育域名。返回 DNS 健康状况（包括 MX 服务商检测）、域名历史记录以及可选的 SSL/…
intelligence_email	一次调用即可验证任意电子邮件地址。检测一次性和临时收件箱，识别角色账户、公共 Webmail 和邮件中继服务，并返回 0-100 的风险评分。如需深入了解送达能力…
intelligence_emailq	深入验证电子邮件送达能力。执行完整的电子邮件验证，并检查 SMTP 收件箱、检测全收型邮箱，返回资格判定结果（有效、无效、有风险、一次性或未知）。
intelligence_ip	评估任意 IP 地址的信誉。检测 VPN、代理、Tor 出口节点、数据中心托管、滥用流量和机器人。返回地理位置、网络所有者以及 0-100 的威胁评分。
intelligence_phone	验证任意 E.164 格式的电话号码。检测一次性和虚拟号码，识别运营商和线路类型（移动电话／固定电话／VoIP），返回国家和时区，并计算 0-100 的风险评分。
stats	获取引擎或端点最近一小时的基础设施运行状况。不限定于你的账户或租户。按账户启用：HTTP 403 表示需联系支持人员开通。
usage	获取 Veille 账户的实时用量统计和额度余额。
vat	根据 VIES 数据库验证欧洲 VAT 号码。返回任意欧盟成员国企业的名称、注册地址和有效性状态。
vat_iban	验证任意 IBAN 并获取关联的银行信息。返回 BIC/SWIFT 代码、银行名称、国家、BBAN 结构拆分以及 SEPA 区域成员资格。
vat_rates	获取任意受支持基准货币的最新 ECB 汇率。可按指定目标货币筛选。汇率每日由欧洲中央银行更新。

每次调用 API 的工具都会消耗额度。JSON 结果以文本形式返回；图片以内嵌形式返回，其他文件（PDF……）则以嵌入资源的形式返回，最大 4 MB。

可流式传输的 HTTP

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

端点为 POST /mcp（无状态，JSON 响应）。每个客户端都在 x-api-key 请求头中发送自己的密钥（或使用 Authorization: Bearer <key>）；服务端不会使用自己的密钥。默认绑定到 127.0.0.1，并会拒绝浏览器来源，除非你明确允许；对外开放前，请在它前面部署 TLS。

为兼容 Fetch 的运行时（Cloudflare Workers、Deno、Bun）导出了 createHttpHandler()：

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。