Entity Enricher

Entity Enricher MCP Server

Entity Enricher 用のホスト型 Model Context Protocol サーバーです。https://entityenricher.ai/api/mcp/（Streamable HTTP）で利用できます。

MCP 対応クライアントから、次のことができます。

• クライアント自身のモデルで任意のジョブを実行できます。デフォルトでは、プラットフォームのモデル呼び出しもクレジットの消費もありません（use_platform_models=true でオプトアウトします）。
• サンプルデータやドキュメントから再利用可能なスキーマを設計し、プロパティを直接編集できます。
• 多言語フィールドや複数のモデルを使って、単一のエンティティまたはリストをエンリッチできます。
• 結果を統合し、成功した作業を繰り返すことなく、失敗した専門領域を復元できます。
• 繰り返し登場するオブジェクトをセマンティックな ID に解決し、別名や不確かな一致を整理できます。
• PostgreSQL、MySQL、SQLite データベース用のリレーショナルテーブルとマイグレーションを導出できます。
• 独自のタスクで、エンリッチメント、サンプル生成、スキーマ生成のベンチマークを実行できます。

スキーマ検証とモデル間の一致は、事実の正確性や鮮度を保証するものではありません。 実際のソース、失敗、部分的な結果を確認してください。生成の成功、エンティティレイヤーへの登録、外部レプリカへの適用は、それぞれ別の結果です。

MCP サーバーのローカルインストールは不要です。オプションのデータベース配信には、レプリカホスト上の ee-database を使用します。DSN はそのホストにとどまります。 マネージドホストは自動でプロビジョニングできますが、手動でのペアリングにも対応しています。

独自のモデルでジョブを実行する

デフォルトでは、すべての開始ツールがジョブを独自のモデルで実行します。ジョブはプラットフォームのモデルを呼び出さず、クレジットも消費しません。MCP クライアントの背後にあるモデルがジョブのすべてのモデル呼び出しに応答し、プラットフォームはプロンプトの作成、出力スキーマの適用、各応答の検証と正規化、レコードの保存、データベースの同期を行います。use_platform_models=true にすると、代わりにプラットフォームの課金対象モデルでジョブを実行します。タスクに対する組織のベンチマーク最良モデルが使用されます（どのモデルが選ばれたか、その理由は結果の model_selection に示されます）。ユーザーがプラットフォームのモデルを指定した場合に限り、そのモデル名を指定してください。

1. 明示的なモデルを指定せずに（省略するか auto を指定して）ジョブを開始し、ツールで選択できる場合は enable_web_search を決定します（省略すると web_search_undecided が返されます。まずユーザーに確認してください）。最初のモデル呼び出しの準備ができると、ジョブは一時停止します。
2. get_job_status の llm_requests を確認します。各エントリは、MCP の sampling/createMessage 形式（システムプロンプト、メッセージ、ツール、toolChoice）での 1 回のモデル呼び出しであり、そのステップを示す purpose と期限を示す expires_at が含まれます。バイナリ添付ファイルはインライン化されず、enricher://attachments/{id} リソースとして参照されます。抽出済みのテキストはすでにメッセージに含まれています。
3. リクエストを独自のモデルで実行し、結果を answer_llm_request で返します。プラットフォームはプロバイダーの応答とまったく同じ方法で検証します。応答が拒否された場合、エラーを含む失敗したツール結果とともに同じ会話が返されるので、修正して再度回答してください。
4. ジョブが完了するまで繰り返します。レコードにはモデルキー mcp::client が付与され、費用はかかりません。リクエストに 15 分以内に回答しないと、ジョブは失敗します（llm_request_timeout）。

オプトアウトによるプラットフォームモデルの使用、ウェブ検索の決定、同時リクエスト、エンリッチメント中の修正リクエスト、添付ファイル、タイムアウトなど、プロトコルの詳細と例外については、 委譲された LLM 呼び出し ガイドを参照してください。

クイックスタート

オプション 1 — OAuth（推奨）

claude.ai、Claude Code、Cursor、および標準の OAuth フローを実装している MCP クライアント向けです。作成や貼り付けが必要な API キーはありません。クライアントが認可サーバーを自動的に検出し、ブラウザーで Entity Enricher の同意画面が開きます。接続は、ご自身のロールで代理操作します。Settings → API Keys → Connected Apps からいつでも取り消せます。

claude mcp add --transport http entity-enricher https://entityenricher.ai/api/mcp/

オプション 2 — API キー（静的 JSON 設定）

対話形式でサインインするのではなく、JSON ファイルで設定するクライアント（Claude Desktop、 Continue、Zed）向けです。また、ヘッドレス環境や CI でも使用できます。

1. Entity Enricher の Web UI で、Settings → API Keys → New organization access key を選択します。ロールを選びます。operator（主に読み取り）、editor（スキーマの作成・編集）、owner（完全な制御。ベンチマークに必要）があります。ent_… の値をコピーします。この値は一度しか表示されません。

2. Claude Desktop の場合、~/Library/Application Support/Claude/claude_desktop_config.json （macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集します：

   {
     "mcpServers": {
       "entity-enricher": {
         "url": "https://entityenricher.ai/api/mcp/",
         "headers": { "X-API-Key": "ent_your_key_here" }
       }
     }
   }
   

   Claude Desktop を再起動します。ファイル全体：examples/claude-desktop/

試してみる

Entity Enricher のスキーマを一覧表示し、「Sanofi」を製薬会社のスキーマに照らして英語とフランス語でエンリッチしてください。

クライアントがツールを検出して選択したスキーマを読み取り、リンク付きで結果を返します。モデルの自動選択が可能です。重要な選択は必要に応じて確認されます。

ガイドとツールの説明

サーバーの指示では、ワークフローについて説明しています。ツールの説明では、前提条件、コスト、重大な影響を含め、個々の呼び出しについて説明しています。詳細なモデリング、復旧、移行のガイダンスは、必要な場合にのみ読み込まれます。

MCP の resources/list を使用して、ガイドのインデックス（enricher://docs）と各ガイドを確認し、目的の URI に対して resources/read を使用してください。ガイドの読み込みでモデルは実行されません。リソースをモデルのコンテキストに取り込む方法はクライアントが決定します。読み込んでもトークンが消費されないとは限りません。

以下の公開レシピは、サーバーが提供するものと同じパッケージ化された Markdownから生成されています。生成されたコピーではなく、メインリポジトリのソースガイドを編集してください。

クライアントが MCP リソースを読み込めない場合は、これらの公開リンクを使用してください。ガイドは個々のツールの仕様を補足するものであり、通常の呼び出しにすべてのガイドを読む必要はありません。

ツール

スキーマ作成とエンリッチメントの全領域を網羅する 59 個のツールです。

データリソース

ジョブとエラー

長時間実行される処理では、このサーバーの開始 → ポーリング → 取得のインターフェイスを使用します。開始ツールは job_id を返します。generate_sample は、返却時にすでに一時停止または完了している場合があります。get_job_status でポーリングし、一時停止中の質問には answer_job_question で回答し、list_records(job_id=...) でレコードを取得してください。メモリ内にジョブが見つからないことは、処理が完了した証拠にはなりません。永続化されたレコードがないか確認してください。キャンセルしても、それ以前のレコードやデータベースへの書き込みは取り消されません。

デフォルトのモデルで実行されるジョブは、質問に加えて llm_requests でも一時停止します。独自のモデルでジョブを実行するを参照してください。

ほとんどの失敗では success: false、error_code、message が返されますが、一部の古いツールでは error または message のみが返されます。MCP のトランスポート応答が成功しても、処理の成功を意味するわけではありません。出力がある場合でも、分類の警告、モデル処理の失敗、部分的または拒否されたデータベース処理の結果を確認してください。詳しい復旧方法については、エンリッチメントガイドを参照してください。

対象範囲と制限

• MCP の単一／一括エンリッチメントツールではウェブ検索を有効にできません。サンプル生成では有効にできます。
• 一括エンリッチメントに固定の 100 エンティティ上限はありませんが、実行中にクォータ／クレジットの制限により残りの処理が停止することがあります。
• 一括処理ツールには database_sync=false オプションがありません。単一エンティティ用ツールにはあります。
• レコードの削除／復元、詳細なコスト分析、ベンチマーク結果のインポート／エクスポート、一部のデータベース管理は、引き続きウェブアプリまたは REST API で行う必要があります。
• スキーマドキュメントは、Entity Enricher の注釈を含むサポート対象の JSON Schema 方言を使用します。直接作成する前に、スキーマリファレンスを参照してください。

リンク

• 公開 MCP ドキュメント
• REST API リファレンス
• クライアント設定
• MCP Registry — ai.entityenricher/enricher。マニフェスト：server.json

このリポジトリについて

この公開リポジトリには、ドキュメントとクライアントの例が含まれています。サーバーは Entity Enricher のバックエンドに組み込まれており、非公開のモノレポで保守されています。このディレクトリは git subtree として同期されています。MIT License の下でライセンスされています。