](https://mseep.ai/app/kunihiros-google-patents-mcp)
谷歌MCP服务器专利(google-patents-mcp)
](https://smithery.ai/server/@KunihiroS/google-patents-mcp) ](https://badge.fury.io/js/%40kunihiros%2Fgoogle-patents-mcp)
该项目提供了一个模型上下文协议（MCP）服务器，允许通过 SerpApi谷歌专利API.
通过Smithery安装
通过以下方式自动安装适用于克劳德桌面的谷歌专利MCP服务器 史密瑟里:
npx -y @smithery/cli install @KunihiroS/google-patents-mcp --client claude更新日志
v0.2.0（2025-04-17）
- 修复： 为实现了空处理程序
resources/list和prompts/listMCP方法。 - 修复： 宣布
prompts服务器初始化能力。 - 家务活： 更新了依赖关系。
这些更改旨在提高与可能需要这些标准端点的MCP客户端（如Claude Desktop）的兼容性，尽管尚未对Claude Desktop进行直接测试。
特性
- 提供MCP工具
search_patents搜索谷歌专利。 - 使用SerpApi作为后端。
- 可以直接使用运行
npx无需本地安装。
先决条件
- Node.js： 建议使用18或更高版本。
- npm： 需要运行
npx命令。 - SerpApi API密钥： 您需要来自的有效API密钥 SerpApi 使用谷歌专利API。
快速入门（使用npx）
运行此服务器的最简单方法是使用 npx。此命令下载（如果需要）并直接运行服务器。
npx @kunihiros/google-patents-mcp注： 替换 @kunihiros/google-patents-mcp 如果实际发布的包名称不同，则使用该名称。
服务器将启动并监听标准输入/输出上的MCP请求。
配置
服务器需要您的SerpApi API密钥。您可以通过以下方式之一提供它：
- 环境变量（建议用于MCP主机）：
设置 SERPAPI_API_KEY 运行服务器时的环境变量。MCP主机配置通常允许为服务器设置环境变量。
MCP主机配置示例代码段(config.json 或类似）：
{
"mcpServers": {
"google-patents-mcp": {
"command": "npx",
"args": [
"-y", // Skips confirmation if the package isn't installed locally
"@kunihiros/google-patents-mcp" // Use the correct package name
],
"env": {
"SERPAPI_API_KEY": "YOUR_ACTUAL_SERPAPI_KEY"
// Optional: Set log level
// "LOG_LEVEL": "debug"
}
}
}
}- .env文件：
创建一个 .env 运行文件的目录中的文件 npx 命令（用于本地测试或如果不使用MCP主机），或在您的主目录中(~/.google-patents-mcp.env)，内容如下：
SERPAPI_API_KEY=YOUR_ACTUAL_SERPAPI_KEY
# Optional: Set log level (e.g., debug, info, warn, error)
# LOG_LEVEL=debug注： 当使用a .env 该文件便于本地测试、生产或与MCP主机集成，建议直接通过主机配置设置环境变量，这是一种更安全的方法。主要预期用例是通过以下方式执行 npx，其中环境变量通常由调用进程或MCP主机管理。
服务器搜索 .env 文件按以下顺序排列： \* ./.env （相对于何处 npx 正在运行） \* ~/.google-patents-mcp.env （在您的主目录中）
提供MCP工具
search_patents
通过SerpApi搜索谷歌专利。
输入架构：
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Search query (required). Although optional in SerpApi docs, a non-empty query is practically needed. Use semicolon (;) to separate multiple terms. Advanced syntax like '(Coffee) OR (Tea);(A47J)' is supported. See 'About Google Patents' for details."
},
"page": {
"type": "integer",
"description": "Page number for pagination (default: 1).",
"default": 1
},
"num": {
"type": "integer",
"description": "Number of results per page (default: 10). **IMPORTANT: Must be 10 or greater (up to 100).**",
"default": 10,
"minimum": 10,
"maximum": 100
},
"sort": {
"type": "string",
"enum": ["relevance", "new", "old"],
"description": "Sorting method. 'relevance' (default), 'new' (newest by filing/publication date), 'old' (oldest by filing/publication date).",
"default": "relevance"
},
"before": {
"type": "string",
"description": "Maximum date filter (e.g., 'publication:20231231', 'filing:20220101'). Format: type:YYYYMMDD where type is 'priority', 'filing', or 'publication'."
},
"after": {
"type": "string",
"description": "Minimum date filter (e.g., 'publication:20230101', 'filing:20220601'). Format: type:YYYYMMDD where type is 'priority', 'filing', or 'publication'."
},
"inventor": {
"type": "string",
"description": "Filter by inventor names. Separate multiple names with a comma (,)."
},
"assignee": {
"type": "string",
"description": "Filter by assignee names. Separate multiple names with a comma (,)."
},
"country": {
"type": "string",
"description": "Filter by country codes (e.g., 'US', 'WO,JP'). Separate multiple codes with a comma (,)."
},
"language": {
"type": "string",
"description": "Filter by language (e.g., 'ENGLISH', 'JAPANESE,GERMAN'). Separate multiple languages with a comma (,). Supported: ENGLISH, GERMAN, CHINESE, FRENCH, SPANISH, ARABIC, JAPANESE, KOREAN, PORTUGUESE, RUSSIAN, ITALIAN, DUTCH, SWEDISH, FINNISH, NORWEGIAN, DANISH."
},
"status": {
"type": "string",
"enum": ["GRANT", "APPLICATION"],
"description": "Filter by patent status: 'GRANT' or 'APPLICATION'."
},
"type": {
"type": "string",
"enum": ["PATENT", "DESIGN"],
"description": "Filter by patent type: 'PATENT' or 'DESIGN'."
},
"scholar": {
"type": "boolean",
"description": "Include Google Scholar results (default: false).",
"default": false
}
},
"required": ["q"]
}输出：
返回一个包含SerpApi搜索结果的JSON对象。该结构遵循SerpApi响应格式。
示例用法（MCP请求）：
{
"mcp_version": "1.0",
"type": "CallToolRequest",
"id": "req-123",
"server_name": "google-patents-mcp",
"params": {
"name": "search_patents",
"arguments": {
"q": "organic light emitting diode",
"num": 10,
"language": "ENGLISH",
"status": "GRANT",
"after": "publication:20230101"
}
}
}发展
- 克隆存储库（如果开发需要）：
# git clone
# cd google-patents-mcp- 安装依赖项：
npm install- 创建
.env文件：
复制 .env.example 向 .env 并添加您的 SERPAPI_API_KEY.
- 构建：
npm run build- 在本地运行：
npm start或者用于自动重建的开发：
npm run dev日志记录
- 日志输出为标准错误。
- 日志级别可以通过以下方式控制
LOG_LEVEL环境变量(error,warn,info,http,verbose,debug,silly).默认为info. - 试图在项目根目录中创建日志文件(
google-patents-server.log)，用户的主目录(~/.google-patents-server.log)，或/tmp/google-patents-server.log.
许可证
MIT许可证（见许可证文件）