Skip to main content
Glama
lgxycsg

Open Patent MCP Gateway

by lgxycsg

Open Patent MCP Gateway

多源专利检索 MCP 网关 — 让 AI Agent 直接搜索全球专利数据库(Google Patents、BigQuery、EPO OPS)。

给你的 AI Agent 加上专利检索(30 秒)

在 GPT Work / Cursor / Claude Desktop 的 MCP 配置中添加:

{
  "mcpServers": {
    "open-patent": {
      "url": "https://open-patent-mcp-gateway.the0shell0.workers.dev/mcp",
      "headers": {
        "Authorization": "Bearer dev-token-local"
      }
    }
  }
}

然后直接对 AI 说:「帮我查一下 lithium battery 固态电解质相关的专利」即可。

可用的 MCP 工具

工具

用途

是否消耗配额

search_patents

关键词/分类号/申请人/日期检索,支持 basic/standard/deep 三档

是

get_patent

按公开号/申请号获取单条专利详情

否

get_family

获取专利族成员和优先权链

否

get_citations

获取引证文献(前引/后引,审查员/申请人)

否

get_legal_status

获取法律状态和法律事件

否

get_drawings

获取附图元数据和图片 URL

否

list_providers

列出已接入的数据库及其能力

否

check_provider_status

检查指定数据库的认证和可用性

否

get_quota_status

查询各数据库的配额余量和重置时间

否

guide_setup

引导用户独立部署(不接收 key,只返回步骤)

否

检索档位

档位

数据源

配额消耗

适用场景

basic

EPO OPS

免费

快速查证、已知分类号检索

standard

EPO OPS + Google Patents

1 次 SerpApi

探索性关键词搜索

deep

全部 + BigQuery 全量历史

1 次 SerpApi + ~0.24 TiB

穷尽式现有技术检索

想自己部署?(v0.2 双模式)

本项目支持两种使用模式:

  • 共享模式(默认):直接用上方 30 秒配置接入维护者的 Worker 与 API,零配置。

  • 独立模式(可选升级):注册自己的 API 与 Cloudflare,部署私有实例。BYOK,密钥只在你自己的 Worker 上。

需要独立部署时,任选一种引导方式:

方式

适合

入口

浏览器引导页

非技术用户

打开 https://open-patent-mcp-gateway.the0shell0.workers.dev/setup

AI 引导

在 GPT Work 等客户端里直接让 AI 帮你部署

对 AI 说「教我独立部署这个 MCP」→ 触发 guide_setup 工具

CLI 向导

喜欢终端的用户

npm run setup

静态文档

离线参考

docs/getting-api-keys.md

四种形态共用同一份数据源 src/onboarding/steps.ts,内容始终一致。

独立模式最低只需 SerpApi 一个 key(standard 档位可用);EPO OPS 与 BigQuery 为可选增强。详细路线图见 docs/v0.2-roadmap.md。

git clone https://github.com/lgxycsg/open-patent-mcp-gateway.git
cd open-patent-mcp-gateway
npm install
npm run setup        # 交互式向导:引导注册 + 验证 key + 生成 .dev.vars
npx wrangler deploy  # 部署到你的 Cloudflare 账号

部署后得到你自己的 https://xxx.workers.dev,替换上方 30 秒配置中的 URL 即可。

项目结构

src/
├─ core/
│  ├─ mcp/server.ts          # MCP server + 10 tools + HTTP/stdio transport
│  ├─ models/                 # PatentRecord, SearchQuery, Identifier
│  ├─ errors/errors.ts        # 15 error codes + secret redaction
│  ├─ routing/router.ts       # Provider router (single/parallel/fallback)
│  ├─ normalization/number.ts # Publication number normalization
│  ├─ deduplication/index.ts  # Dedup + family aggregation
│  └─ security/secrets.ts     # Credential management + token validation
├─ onboarding/                # v0.2 独立模式引导(单一数据源 + 网页 + 验证)
│  ├─ steps.ts                # 4 种引导形态共用的步骤数据源
│  ├─ setup-page.ts           # Worker /setup 路由的 HTML 渲染器
│  └─ verify.ts               # /setup/verify 服务端 key 验证(无状态)
├─ providers/
│  ├─ mock/index.ts           # Mock provider (testing)
│  ├─ epo_ops/                # EPO OPS (official API, OAuth)
│  ├─ google_patents/         # Google Patents via SerpApi
│  ├─ bigquery/               # Google Patents Public Datasets
│  ├─ types.ts                # Provider interface + Manifest
│  └─ registry.ts             # Static provider registry
├─ worker.ts                  # Cloudflare Workers entry
└─ index.ts                   # Node.js entry

测试

npm run typecheck   # 类型检查
npm test            # 388 个单元测试
npm run build       # 编译

许可证

MIT

Related MCP Connectors