Entity Enricher

Entity Enricher MCP 服务

一个托管的 Model Context Protocol 服务，适用于 Entity Enricher，地址为 https://entityenricher.ai/api/mcp/（Streamable HTTP）。

使用兼容 MCP 的客户端，你可以：

• 在客户端自己的模型上运行任意任务。默认情况下，不调用平台模型，也不消耗额度（设置 use_platform_models=true 即可选择退出此模式）。
• 根据示例数据或文档设计可复用的架构，并直接编辑属性。
• 使用多语言字段和多个模型来丰富单个实体或实体列表。
• 合并结果，并恢复失败的专业领域任务，而不重复已成功的工作。
• 将重复出现的对象解析为语义身份，并整理其别名或不确定匹配项。
• 为你的 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 格式（system prompt、messages、tools、toolChoice），包含用于说明步骤的 purpose 和截止时间 expires_at。二进制附件会以 enricher://attachments/{id} 资源的形式引用，绝不会内联；提取出的文本已包含在消息中。
3. 在自己的模型上执行该请求，并通过 answer_llm_request 提交结果。平台会按照验证提供方回答的相同方式验证该结果；如果回答未通过验证，系统会返回相同的对话，并在失败的工具结果中附上错误，以便修正后再次回答。
4. 重复上述步骤，直到任务完成。记录会以零成本标记模型键 mcp::client；十五分钟后仍未回答的请求会导致任务失败（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 选项；单实体工具支持此选项。
• 删除/恢复记录、详细成本分析、基准测试结果导入/导出，以及部分数据库管理功能仍需在 Web 应用或 REST API 中完成。
• 架构文档使用受支持的 JSON Schema 方言，并包含 Entity Enricher 注解；直接编写架构前，请参阅架构参考。

链接

• MCP 公共文档
• REST API 参考
• 客户端配置
• MCP Registry — ai.entityenricher/enricher；清单：server.json

关于此代码库

此公共代码库包含文档和客户端示例。服务内嵌于 Entity Enricher 后端中，并在私有单体代码库中维护；此目录以 git 子树的形式同步。 根据 MIT License 授权。