关键词

Google Patents search专利信息检索SerpApi专利工具知识产权

使用说明

项目简介

本项目 'google-patents-mcp' 是一个基于 Model Context Protocol (MCP) 的服务器实现，它提供了一个名为 'search_patents' 的工具，允许用户通过 MCP 协议调用来搜索 Google Patents 的信息。该服务器使用 SerpApi Google Patents API 作为后端服务，并将搜索功能以 MCP 工具的形式暴露出来，方便 LLM 应用集成和调用。

主要功能点

  • 提供 MCP 工具 'search_patents': 用于搜索 Google Patents 数据库。
  • 基于 SerpApi: 利用 SerpApi 强大的 Google Patents API 接口。
  • 易于部署和运行: 可以通过 'npx' 命令直接运行，无需本地安装。
  • 灵活配置: 支持通过环境变量配置 SerpApi API 密钥和日志级别。
  • 详细日志: 提供详细的日志输出，方便调试和监控。

安装步骤

由于该 MCP 服务器可以通过 'npx' 直接运行，因此无需传统的安装步骤。您只需要确保您的环境中安装了 Node.js (版本 18 或更高) 和 npm。

服务器配置

对于 MCP 客户端，配置此 MCP 服务器主要涉及提供正确的启动命令和必要的参数。以下是一个典型的 MCP 客户端配置示例 (以 JSON 格式):

{
  "mcpServers": {
    "google-patents-mcp": {
      "command": "npx",
      "args": [
        "-y",  // 可选，如果未本地安装包，跳过确认直接安装
        "@kunihiros/google-patents-mcp" // MCP服务器的 npm 包名
      ],
      "env": {
        "SERPAPI_API_KEY": "YOUR_ACTUAL_SERPAPI_KEY"  // **必须配置**: 您的 SerpApi API 密钥
        // "LOG_LEVEL": "debug"  // 可选: 设置日志级别 (debug, info, warn, error, 等)
      }
    }
  }
}

配置参数说明:

  • 'server name': 'google-patents-mcp' (客户端用于识别和调用此服务器的名称)
  • 'command': 'npx' (用于执行 npm 包的命令)
  • 'args': 启动服务器的参数列表:
    • '"-y"': 可选参数，用于在使用 'npx' 运行未安装的包时跳过安装确认提示，实现静默安装和运行。
    • '"@kunihiros/google-patents-mcp"': 必须，指定要通过 'npx' 运行的 npm 包名称，即此 MCP 服务器的包。
  • 'env': 环境变量配置:
    • '"SERPAPI_API_KEY"': 必须，您需要从 SerpApi 获取的 API 密钥，用于访问 Google Patents API。请替换 '"YOUR_ACTUAL_SERPAPI_KEY"' 为您的真实密钥。
    • '"LOG_LEVEL"': 可选，用于设置服务器的日志级别。默认为 'info'。可以设置为 'debug'、'warn'、'error' 等更详细或更简洁的日志级别，方便调试或生产环境监控。

重要提示: 请务必将 '"SERPAPI_API_KEY"' 替换为您在 SerpApi 官网申请的有效 API 密钥。这是服务器能够正常工作的必要条件。

基本使用方法

配置完成后，MCP 客户端可以通过发送 'CallToolRequest' 请求来调用 'search_patents' 工具。以下是一个示例请求 (JSON 格式):

{
  "mcp_version": "1.0",
  "type": "CallToolRequest",
  "id": "req-search-patents-1",
  "server_name": "google-patents-mcp",
  "params": {
    "name": "search_patents",
    "arguments": {
      "q": "organic light emitting diode",  // 搜索关键词 (必填)
      "num": 10,                           // 每页结果数 (可选, 默认 10, 最小 10, 最大 100)
      "language": "ENGLISH",               // 语言 (可选)
      "status": "GRANT",                   // 专利状态 (可选, GRANT 或 APPLICATION)
      "after": "publication:20230101"      // 发布日期下限 (可选, 格式: type:YYYYMMDD)
    }
  }
}

请求参数说明:

  • 'server_name': 必须与 MCP 客户端配置中 'mcpServers' 下定义的服务器名称一致，这里是 '"google-patents-mcp"'。
  • 'params.name': 要调用的工具名称，这里是 '"search_patents"'。
  • 'params.arguments': 工具的参数，具体参数定义请参考 'search_patents' 工具的 Input Schema。其中 'q' (搜索关键词) 是必填参数。

服务器收到请求后，将调用 SerpApi Google Patents API 进行搜索，并将搜索结果封装在 JSON 响应中返回给 MCP 客户端。

信息

分类

网页与API

访问项目