mcp-enrichment

@opafex/mcp-enrichment

用于多来源实体信息补充的 MCP 服务 — 公司数据、联系人查找、电子邮件验证、电话号码验证和电子邮件发现。

使用 Clearbit、Hunter.io 和 Twilio API。未配置 API 密钥时，可在模拟模式下运行。

安装

# Clone and build from source
git clone https://github.com/opafex/opafex-mcps.git
cd opafex-mcps
npm install && npm run build

需要 Node.js 20+。

快速开始

添加到 Claude Code / Claude Desktop

在项目根目录中创建或编辑 .mcp.json：

{
  "mcpServers": {
    "enrichment": {
      "command": "node",
      "args": ["/path/to/opafex-mcps/packages/enrichment/dist/index.js"],
      "env": {
        "CLEARBIT_API_KEY": "sk-...",
        "HUNTER_API_KEY": "...",
        "TWILIO_ACCOUNT_SID": "...",
        "TWILIO_AUTH_TOKEN": "..."
      }
    }
  }
}

省略 env 块即可在模拟模式下运行。

工具

enrich_company

根据域名或公司名称补充公司数据。返回所属行业、员工人数、融资情况、技术栈、社交媒体资料等信息。

提供方： Clearbit

{
  "success": true,
  "company": {
    "name": "Company for stripe.com",
    "domain": "stripe.com",
    "description": "A leading technology company specializing in innovative solutions.",
    "industry": "Technology",
    "sector": "Software",
    "employees": 150,
    "employeesRange": "101-250",
    "founded": 2015,
    "location": { "city": "London", "country": "United Kingdom" },
    "socialProfiles": { "linkedin": "https://linkedin.com/company/example" },
    "techStack": ["React", "Node.js", "PostgreSQL", "AWS"],
    "type": "private"
  },
  "provider": "mock",
  "cached": false,
  "timestamp": "2026-03-15T00:00:00.000Z"
}

enrich_contact

根据电子邮件地址或 LinkedIn URL 补充联系人/个人数据。

提供方： Clearbit

verify_email

验证电子邮件地址是否可送达。返回有效性、可送达评分、一次性/免费服务提供方检测、基于角色的地址检测和 SMTP 验证结果。

提供方： Hunter.io

{
  "success": true,
  "email": "[email protected]",
  "valid": true,
  "deliverable": true,
  "disposable": false,
  "freeProvider": false,
  "role": false,
  "score": 95,
  "provider": "mock",
  "cached": false
}

verify_phone

验证并查询电话号码。返回有效性、格式化后的号码、线路类型（移动电话/固定电话/VoIP）、运营商信息和位置。

提供方： Twilio

find_email

查找某人在某公司的电子邮件地址。

提供方： Hunter.io

{
  "success": true,
  "email": "[email protected]",
  "score": 85,
  "sources": ["LinkedIn", "Company Website"],
  "provider": "mock",
  "cached": false
}

server_info（内置）

返回服务元数据：名称、版本、已注册工具和资源。由 @opafex/mcp-shared 自动添加。

资源

模拟模式

未配置 API 密钥时，所有工具都会返回逼真的模拟数据。这非常适合开发和测试 — 无需任何 API 账户，即可基于 MCP 开发。

模拟模式会自动启用：

• 全局启用： 未设置 CLEARBIT_API_KEY、HUNTER_API_KEY 或 TWILIO_ACCOUNT_SID 中的任何一个
• 按工具启用： 缺少特定提供方的密钥时（例如，仅设置 CLEARBIT_API_KEY 时，公司/联系人工具会使用真实数据，而电子邮件/电话工具则会回退到模拟数据）

查看 enrichment://status 资源或 server_info 工具，了解哪些提供方已启用。

环境变量

开发

npm run build    # Compile TypeScript
npm run dev      # Run with tsx (no build needed)
npm test         # Run tests
npm start        # Run compiled server

库用法

丰富服务可通过编程方式使用（不仅限于作为 MCP 服务）：

import { EnrichmentService } from '@opafex/mcp-enrichment/service';
import type { CacheProvider } from '@opafex/mcp-enrichment/service';

const service = new EnrichmentService({
  clearbitApiKey: 'sk-...',
  hunterApiKey: '...',
});

const result = await service.enrichCompany({ domain: 'stripe.com' });

自定义缓存提供程序

默认的内存缓存开箱即用。对于 Redis、SQLite 或任何自定义存储，请实现 CacheProvider 接口：

import { EnrichmentService } from '@opafex/mcp-enrichment/service';
import type { CacheProvider } from '@opafex/mcp-enrichment/service';

const redisCache: CacheProvider = {
  async get(key) { /* ... */ },
  async set(key, data, ttlMs) { /* ... */ },
  async delete(key) { /* ... */ },
  async clear() { /* ... */ },
};

const service = new EnrichmentService({
  clearbitApiKey: '...',
  cache: redisCache,
});

贡献

发现错误或有功能请求？提交 issue。

欢迎提交拉取请求——开发环境配置请参阅主仓库。

许可证

MIT——请参阅 LICENSE。