MCP 服务器（Claude Desktop / Code / Cursor）

通过兼容 MCP 的客户端使用 Entity Enricher，将模型知识和文档转化为结构化数据。设计模式、以多种语言富化实体、融合模型、管理语义标识、评测质量，并将关系表同步到你自己的数据库。

模式校验以及模型之间的一致性并不能保证内容的事实准确性或时效性。请检查来源、失败项以及部分写入数据库的结果。MCP 提供对话式访问；n8n 和 Make 基于同一服务提供工作流自动化。

快速开始

方式 1 — OAuth（推荐）

适用于 claude.ai、Claude Code、Cursor 以及任何支持标准 OAuth 流程的 MCP 客户端。无需创建或粘贴 API 密钥——客户端会自动发现授权服务器。

将 Entity Enricher 添加为连接器（在 claude.ai 中：设置 → 连接器 → 添加自定义连接器，或从目录中选择），URL 为 https://entityenricher.ai/api/mcp/。
浏览器将打开 Entity Enricher 授权确认页面——如有需要请登录，然后点击授权。该连接将以你自己的角色代表你执行操作。
可随时在 API 密钥 → 已连接应用 下管理或撤销连接——撤销将立即切断访问权限。

Entity Enricher 的授权确认页面，询问是否允许 claude.ai 代表已登录的所有者执行操作 — OAuth 流程中你会看到的唯一一个 Entity Enricher 界面：它标明本次授权所限定的组织，以及授权将使用的角色——也就是你自己的角色。

方式 2 — API 密钥（静态 JSON 配置）

适用于通过 JSON 文件配置而非交互式登录的客户端（Claude Desktop、Continue、Zed）。

1. 创建 API 密钥
在 Entity Enricher 网页界面中：设置 → API 密钥 → 新建组织访问密钥。选择一个角色（operator 主要用于只读，editor 用于创建/编辑 schema，owner 拥有完全控制权）。复制 ent_… 值——它只会显示一次。
2. 在您的 MCP 客户端中注册
对于 Claude Desktop，请编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：
```
{
  "mcpServers": {
    "entityenricher": {
      "url": "https://entityenricher.ai/api/mcp/",
      "headers": { "X-API-Key": "ent_your_key_here" }
    }
  }
}
```
在客户端的远程 MCP 配置中使用上方的端点和请求头。配置语法及 HTTP 传输支持情况因客户端而异。

试一试

在新的对话中：“列出我的 Entity Enricher 模式，然后使用 Claude Sonnet 针对制药公司模式增强 Sanofi。”客户端可以发现这些工具，并用它们选择模式并运行增强。确认提示、进度显示和资源访问方式取决于客户端。

工具

58 个工具涵盖模式编写、增强、基准测试、数据库同步和语义标识。它们复用后端服务进行校验、计费和处理。每个工具都公开各自支持的参数。长时间运行的任务（批量增强、样本生成、基准测试运行）是异步的：启动工具返回 job_id，客户端轮询 get_job_status并读取生成的记录或基准测试结果。在报告成功之前，请先检查失败和部分完成的结果。

类别	工具	描述
发现	list_models	列出可用的模型键、标称能力、语言、策略、自动选择的默认值以及组织的 profile_limits。
Schema	generate_sample	根据自由文本请求生成可编辑的样本 JSON，用于模式编写。
Schema	list_schemas	列出组织中已保存的模式，置顶的排在前面。
Schema	get_schema	查看已保存的模式及其属性、注解和 input_contract。
Schema	create_schema_from_sample	根据已审核的样本生成并自动保存模式，返回 schema_id、模式内容和记录链接。
Schema	save_schema	保存直接编写的模式，并返回其 ID 和链接。
Schema	update_schema	编辑已保存模式的元数据，或无需调用 LLM 即可替换其完整的 schema_content。
Schema	get_schema_part	仅读取编辑所需的模式片段。
Schema	get_enum_candidates	列出各开放枚举当前词汇表之外的已观测值，并附上近期富集记录中的出现次数。
Schema	update_schema_property	按路径编辑或删除单个属性，无需替换整个模式。
Schema	add_schema_property	在根节点 (parent_path=')、某个对象路径或 '$defs.X' 下添加属性。
Schema	move_schema_property	将某个属性移动到根、对象路径或 '$defs.X' 下，同时保留其标记和专业领域。
Schema	resolve_unify_proposal	处理 get_schema 中一条待定的实体类型统一提议。
Schema	nest_schema_region	将 get_schema 的 x-entityMap 中的某个扁平实体区域嵌套为承载其字段的对象的子对象：该区域的扁平成员（例如订单上的 product_id、product_name…
Schema	publish_schema	将数据库关联模式的工作副本发布为富集和副本所使用的契约。
Schema	delete_schema	按 UUID 软删除已保存的模式。
Schema	analyze_sample	在生成模式之前，先分析样本的属性歧义与关系身份作用域。
Schema	analyze_schema	分析已保存模式的属性歧义与关系身份作用域，并将注释写入该模式。
增强与融合	start_batch_enrichment	对实体列表启动计费的异步富化，schema_id 与 target_schema 必须且只能提供其一。
增强与融合	fetch_entities	通过服务端 GET 请求从外部 REST API 获取实体。
增强与融合	enrich_entity	针对 schema_id 或 target_schema 二者之一（且仅一个）增强单个实体，返回结构化输出、record_id、成本以及任何数据库处理结果。
增强与融合	retry_expertises	仅重试现有记录中失败的专业领域，然后更新其输出并尝试本次运行的融合/同步。
增强与融合	merge_records	将同一实体的两条或多条记录融合为一条新的仲裁记录。
作业控制	get_job_status	查看作业的状态、进度，以及包含已持久化记录 ID 的精简终态摘要。
作业控制	cancel_job	请求取消处于待处理、运行中或已暂停状态的 LLM 作业。
作业控制	answer_job_question	提供暂停时返回问题的答案，以恢复已暂停的作业。
记录与统计	list_records	分页列出组织中的精简记录，最新的排在前面。
记录与统计	get_record	查看单条已持久化记录的 structured_output、entity_input_data、校验错误、专业领域判定和指标。
记录与统计	get_stats	查看组织范围内的记录总数、成功率、令牌数和成本汇总。
基准测试	list_benchmark_scenarios	列出精简的基准测试场景摘要及总数。
基准测试	get_benchmark_scenario	查看单个基准测试场景，包含各模型的质量、成本和速度结果。
基准测试	get_benchmark_scenario_results	筛选、排序并限制某个场景各模型的基准测试结果。
基准测试	create_benchmark_scenario	创建可复用的基准测试，必须配置评分判定器。
基准测试	update_benchmark_scenario	编辑基准测试的测试定义或评分配置。
基准测试	set_benchmark_reference	保存富化或模式生成基准测试的黄金参考答案。
基准测试	delete_benchmark_scenario	删除基准测试场景及其已存储的结果。
基准测试	run_benchmark	启动计费的异步基准测试执行与评分。
附件	upload_attachment	以 base64 上传文件字节作为可复用的源材料；返回 id 和 requires_capability。
附件	delete_attachment	永久删除组织中的某个附件，包括其存储的文件。
Database Sync	list_database_syncs	列出已保存模式的数据库注册、关联模式、选项和同步主机。
Database Sync	list_entity_states	浏览某个模式当前已合并的实体行，而非单次运行的记录。
Database Sync	create_database_sync	注册已保存的模式，以便关系型同步到 PostgreSQL、MySQL 或 SQLite。
Database Sync	assign_sync_host	指定或清除负责配置数据库同步的主机。
Database Sync	classify_database_model	针对已关联的模式启动计费分析，提出数据库键、SQL 类型、索引和关系归属建议。
Database Sync	delete_database_sync	删除数据库注册及其排队中的增量，停止其数据推送。
Database Sync	create_database_credential	签发一次性同步客户端凭据，并给出安装/配对/运行命令建议。
Database Sync	fetch_database_deltas	读取数据库同步的下一个有序 SQL 增量与规范化载荷窗口。
Database Sync	ack_database_deltas	成功应用后，通过 up_to_id 确认每个增量，并释放其租约。
Database Sync	sync_records_to_database	校验已存储或所提供的富化输出，并将其注入实体层和已关联的同步。
语义 ID	list_semantic_concepts	浏览组织概念，包含别名、使用次数以及类型/模型分面。
语义 ID	get_semantic_concept	查看单个概念的别名、身份来源键、关联记录，以及其所属类型/模型切片内的最近邻。
语义 ID	probe_semantic_concept	预览身份解析，不会新增概念或增加其使用次数。
语义 ID	add_semantic_concept	以零使用量添加身份概念，或使用 alias_of 将文本添加为别名。
语义 ID	update_concept_alias	使用 get_semantic_concept 返回的别名 ID 删除或提升概念别名。
语义 ID	import_semantic_concepts	针对单个概念类型解析 1..1000 条文本。
语义 ID	merge_semantic_concepts	将落选概念合并到胜出概念中。
语义 ID	delete_semantic_concepts	按 ids、concept_types 或 unused_only 选择并删除概念。
语义 ID	migrate_semantic_embeddings	查看或迁移组织的概念嵌入空间。

按需加载的工作流指南

服务器说明介绍可用的工作流；工具说明解释单个调用。如需进行建模决策或故障恢复，你的客户端可在 enricher://docs 读取指南索引，并通过 MCP 资源选择指南。阅读指南不会运行模型。下方链接会打开公共仓库中相同的英文指南。

从样本生成模式
依据已审核的示例设计可复用的模式，包括身份、关系和多语言字段。
模式格式与定向编辑
读取、编写和编辑 Entity Enricher 模式文档，避免混淆序列化的 JSON Schema、示例数据和属性工具路径。
文档与基于来源的样本
选择抽取、知识增强或两轮组合方式，并在多次调用之间保留附件来源信息。
增强、融合与恢复
增强实体，解读其实际结果，并在不重复已成功工作的前提下恢复部分模型的失败。
批量丰富化
异步增强实体列表，并区分已跳过、失败、已融合和已写入数据库的结果。
模型基准测试
在增强、样本生成或模式生成上比较模型，使用正确的参考基准和分数解读方式。
数据库同步与迁移
将富化模式转换为你自己数据库中的关系表，并分别验证准入、迁移和副本投递情况。
语义标识与词汇管理
识别不同表述形式下重复出现的实体，审核不确定的匹配，并了解词汇表变更对副本的影响。

资源

资源以 Markdown 形式提供模式和记录数据以及工作流指南。客户端自行决定如何发现和加载它们；资源内容仍会占用模型上下文。

URI 模板	描述
enricher://docs	工作流指南索引，每个指南均可通过其列出的资源 URI 访问。
enricher://schemas/{schema_id}	已保存模式工作副本的 Markdown 形式；如需当前关联生效的契约，请使用 get_schema 并设置 version="published"。
enricher://records/{record_id}	以 Markdown 呈现的过往扩充记录——元数据 + 结构化输出 + 校验错误。

交互式分类处理

当你要求 enrich_entity 使用分类模型，而实体与架构类型不匹配时，该工具会返回一个非错误响应，其中包含结构化的详细信息。Claude 会读取该响应，将推理过程呈现给你，并（在你确认后）使用 force_after_classification_warning=true 重试——即在重试时跳过分类器。

{
  "success": false,
  "error_code": "classification_warning",
  "message": "Pre-flight classification rejected the entity. ...",
  "classification": {
    "status": "mismatch",
    "reasoning": "Titan is a moon of Saturn, not a planet.",
    "confidence": 0.97
  },
  "job_id": "..."
}

MCP 响应会保留分类详情，以便你的客户端在发起新调用前解释该决策。

同样的交互能力也驱动着第二种流程：当 generate_sample 带源文档运行时，其规划器可能会暂停并提出结构性澄清问题。Claude 会将它们转达给你，并通过 answer_job_question 恢复作业——一轮接一轮，直到样本生成完毕。

错误代码

大多数工具错误会返回带有 error_code 字段的结构化对象，便于客户端区分配额、分类、超时和提供商故障。部分较早的响应仅包含 error 或 message 字段；请同时检查实际结果和传输状态。

error_code	时间
invalid_request	UUID 格式错误、参数互斥（schema_id + target_schema），或请求体验证失败。
prompt_limit_reached	每日／每周／每月 prompt 配额已用尽（HTTP 402）。响应体包含 period、limit、used、needed。
insufficient_credits	组织已启用计费，但信用额余额过低，无法启动任务（HTTP 402）。响应正文包含余额和购买链接。
model_limit_exceeded	请求的模型数量超出套餐允许范围（HTTP 402）。会回显限制值与请求值。
language_limit_exceeded	请求的语言数量超出套餐允许范围（HTTP 402）。
concurrent_job_limit_reached	该组织正在运行的富集任务过多。请等待或升级套餐。
classification_warning	⚡ 非错误：预检 classifier 拒绝了该 entity。响应中携带 classification 上下文，以便 Claude 请用户确认，并使用 force_after_classification_warning=true 重试。
benchmarks_not_in_plan	该组织套餐不包含模型基准测试（HTTP 403）。变更类基准测试工具还会校验所有者角色。
ambiguity_check_disabled	对一个已关闭歧义检查的架构调用了 analyze_schema（HTTP 400）。请先通过 update_schema 设置 ambiguity_check_enabled=true 重新启用。
enrichment_timeout	作业超过 timeout_seconds。建议减少模型数量或拆分实体。
schema_generation_timeout	Schema 生成超过 timeout_seconds。
schema_generation_failed	生成 schema 时上游 LLM 出错（HTTP 502）。
model_output_invalid	模型返回的输出与 schema 不匹配（HTTP 502）。响应正文中会给出模型名称、出错的属性路径以及 retryable: true —— 请再次调用该工具，或选择更强的 model。
cancelled	作业在运行中被取消（HTTP 499）。
not_found	Schema 或记录 ID 在您的组织中不存在。
http_error	用于捕获没有结构化详情正文的 HTTP 错误。

有意省略的部分

自定义提示词（playground）——Claude 本就能运行任意提示词，将其封装为工具显得多余。
记录删除 / 基准测试结果导入导出 — 这些操作仅保留在网页界面中。
增强选项 — 单条和批量增强工具均未开放联网搜索开关；批量工具还缺少单次运行的数据库同步退出选项。
成本分析 — get_stats 提供聊天端的摘要；完整的仪表板仍保留在应用中。

另请参阅

REST API 参考 — MCP 所封装的端点。
n8n 连接器 — 用于工作流自动化。
Make.com 连接器——用于基于场景的流水线。
Model Context Protocol — 服务器实现的开放规范。
GitHub 上的 mcp-server-entity-enricher——客户端配置、方案演练以及问题跟踪。