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をご覧ください。