Epo Publication Server

@pipeworx/epo-publication-server

按公布版本提供的欧洲专利文献——公布日期、按日期列出的文献（含标题和申请人），以及授权专利和直接提交申请的完整文献文本（书目信息、摘要、权利要求、 说明书）。无需密钥。

属于 Pipeworx——一个将 AI Agent 连接到 1879+ 个实时数据源的 MCP 网关。这是独立的非官方集成，与上游提供方无关联、未获其认可，也非由其发布。

工具

• eps_publication_dates(year?, from?, to?, limit?) — EPO 公布日期 （每周一次，几乎总是星期四，最早可追溯至 1978 年），包含每个日期的 实际文献数量。
• eps_list_publications(date, kind?, limit?) — 某一日期发布的所有 EP 文献， 含种类代码、标题和申请人；会报告筛选前的实际总数。
• eps_get_document(number, kind?, part?) — 获取某篇公布文献按公布版本 提供的书目信息、摘要、权利要求或说明书文本。

身份验证

无需密钥。无需账户，无需注册。

EPO 规定，每个调用 IP 在滚动 7 天内的合理使用上限为 5 GB；可通过响应 标头 x-quotaperweek-remaining/x-quotaperweek-used 实时确认。适用 EPO 网站的一般条款；未发现针对 EPS 的特定再分发限制。

数据来源

• 欧洲专利局（EPO），European Publication Server——所有 EP 专利申请和已授权欧洲 专利按公布版本提供的 XML/HTML。

给下一位开发者的说明

• 按日期查询列表的陷阱：查询并非 EPO 实际公布日期的日期（星期几错误、 未来日期、输入错误）时，会返回 HTTP 200 和一个很小的 HTML 外壳，且无条目—— 不是 404，也不是错误。在 2,400 多周的历史记录中，EPO 从未出现过真正没有文献的 公布日期，因此 eps_list_publications 会将解析出的条目数为零视为明确失败，而不是 静默返回空列表。务必先从 eps_publication_dates 获取真实日期。
• 大多数申请（A 类）公布文献不含权利要求/说明书文本。 绝大多数 EP 申请通过 PCT 途径提交，EPO 仅重新发布这些申请的书目信息 （SDOBI）记录——完整说明书已作为 WIPO（WO）小册子发布，因此 EPO 不会重新录入。 已授权（B 类）专利以及直接提交的（非 PCT）申请通常都能可靠地提供完整的权利要求/ 说明书/附图文本。eps_get_document 会说明查询到的是哪种情况（如果是 PCT 案件， 还会注明引用的 WO 公布文献），而不是静默返回空内容。
• **文献 ID 不只是公布号加种类代码。**REST 路径段是更长的 ID，例如 EP4819826NWA1——由公布号、内部标记（绝大多数文献为 NW，少数为 W1） 和种类代码组成。eps_list_publications 会直接返回这些 ID；eps_get_document 也接受不带标记的号码加种类代码，并按顺序尝试常见的 ID 格式。
• 虚构的文献 ID 不会返回 404——而是返回 500，并附带一个很小的 JSON 正文 （{"code":9000,"message":"Unhandled internal server error."}）。实际上这很容易处理： eps_get_document 会尝试候选 ID，全部失败后会报告 found:false 和上游状态码。
• 相比 mcps/epo-ops（EPO Open Patent Services，OAuth2），本工具新增了什么：无需密钥即可 获取按公布版本提供的文献文本。epo-ops 提供 INPADOC 全球法律状态，以及针对 DOCDB（100 多个专利局）的 CQL 搜索；本工具仅涉及 EP 公布文献。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "epo-publication-server": {
      "url": "https://gateway.pipeworx.io/epo-publication-server/mcp"
    }
  }
}

此端点实际提供的内容

tools/list 在 https://gateway.pipeworx.io/epo-publication-server/mcp 返回上表中的工具，以及 Pipeworx 的共享元工具——ask_pipeworx、discover_tools、search_within、remember/recall 等网关级工具。因此，你看到的工具数量会多于此表：目前，单个工具包端点除了列出自身的工具外，还会列出大约 30 个共享工具。连接的 initialize 响应会说明其确切范围，也是判断当天范围的权威依据。

这是有意为之，并非意外地进行了多路复用。元工具让受限连接也能回答此工具包未涵盖的问题——通过 ask_pipeworx 跨整个目录路由——无需再添加第二个 MCP 服务。目前无法在不包含这些元工具的情况下挂载工具包端点；如果额外的架构定义占用的上下文超过了路由功能带来的价值，请连接一次完整网关，而不是连接多个工具包端点。

或者，连接完整的 Pipeworx 网关，直接列出每个工具包的工具，而不只是此工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

这两个 URL 都连接到同一个网关和相同的 1879+ 个数据源。唯一的区别是直接列出哪个工具包的工具；ask_pipeworx 可从任一端点访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/eps_publication_dates \
  -H 'Content-Type: application/json' \
  -d '{"year":"2026","limit":5}'

首次调用无需账户。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/eps_publication_dates。查找工具：使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。

独立运行（无需网关账户）

此软件包也可作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需经过网关：

{
  "mcpServers": {
    "epo-publication-server": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-epo-publication-server"]
    }
  }
}

也可以直接运行，以确认它能够启动：

npx -y @pipeworx/mcp-epo-publication-server

它通过 stdin/stdout 使用 MCP，并响应 initialize/tools/list/tools/call，仅提供此工具包的工具——不包含上述网关连接额外提供的共享元工具。来源相同，工具相同，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

你也可以用通俗的英语提问，而不是直接调用工具——无论使用上面的工具包端点还是完整网关，都可以这样操作：

ask_pipeworx({ question: "your question about Epo Publication Server data" })

网关会自动选择合适的工具并填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT