Google Patents MCP Server

Integrations

  • Supports configuration via .env files, allowing users to securely provide API keys and configure logging levels without exposing sensitive information.

  • Provides a tool for searching Google Patents information, allowing users to query patent data with various filters like dates, inventors, assignees, countries, and languages via the SerpApi Google Patents API.

  • Offers optional inclusion of Google Scholar results when searching for patents, allowing users to retrieve academic research related to patent searches.

Сервер Google Patents MCP ( google-patents-mcp )

Этот проект предоставляет сервер Model Context Protocol (MCP), который позволяет осуществлять поиск информации о патентах Google через API SerpApi Google Patents .

Установка через Smithery

Чтобы автоматически установить Google Patents MCP Server для Claude Desktop через Smithery :

npx -y @smithery/cli install @KunihiroS/google-patents-mcp --client claude

Журнал изменений

v0.2.0 (2025-04-17)

  • Исправление: Реализованы пустые обработчики для методов MCP resources/list и prompts/list .
  • Исправление: Объявлена возможность prompts при инициализации сервера.
  • Задача: Обновление зависимостей.

Эти изменения направлены на улучшение совместимости с клиентами MCP, такими как Claude Desktop, которым могут потребоваться эти стандартные конечные точки, хотя прямое тестирование с Claude Desktop еще не проводилось.

Функции

  • Предоставляет инструмент MCP search_patents для поиска в Google Patents.
  • Использует SerpApi в качестве бэкэнда.
  • Можно запустить напрямую с помощью npx без локальной установки.

Предпосылки

  • Node.js: рекомендуется версия 18 или выше.
  • npm: Требуется для запуска команды npx .
  • Ключ API SerpApi: для использования API Google Patents вам понадобится действительный ключ API от SerpApi .

Быстрый старт (с использованием npx)

Самый простой способ запустить этот сервер — использовать npx . Эта команда загружает (при необходимости) и запускает сервер напрямую.

npx @kunihiros/google-patents-mcp

Примечание: замените @kunihiros/google-patents-mcp фактическим опубликованным именем пакета, если оно отличается.

Сервер запустится и будет прослушивать запросы MCP на стандартном вводе/выводе.

Конфигурация

Сервер требует ваш ключ API SerpApi. Вы можете предоставить его одним из следующих способов:

  1. Переменная среды (рекомендуется для хостов 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" } } } }
  2. Файл .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
    Примечание: Хотя использование файла .env удобно для локального тестирования, для производства или интеграции с хостами MCP, установка переменной среды напрямую через конфигурацию хоста является рекомендуемым и более безопасным подходом. Основной предполагаемый вариант использования — выполнение через npx , где переменные среды обычно управляются вызывающим процессом или хостом MCP.

Сервер ищет файлы .env в следующем порядке: * ./.env (относительно того места, где запущен npx ) * ~/.google-patents-mcp.env (в вашем домашнем каталоге)

Предоставленный инструмент MCP

search_patents

Поиск в Google 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"] }

Выход:

Возвращает объект JSON, содержащий результаты поиска из SerpApi. Структура соответствует формату ответа 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" } } }

Разработка

  1. Клонируйте репозиторий (если это необходимо для разработки):
    # git clone <repository-url> # cd google-patents-mcp
  2. Установите зависимости:
    npm install
  3. Создайте файл .env : скопируйте .env.example в .env и добавьте свой SERPAPI_API_KEY .
  4. Строить:
    npm run build
  5. Запустить локально:
    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 (см. файл LICENSE)

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Сервер Model Context Protocol, который позволяет осуществлять поиск информации о патентах Google через API SerpApi Google Patents, позволяя пользователям запрашивать патентные данные с использованием различных фильтров и параметров сортировки.

  1. Установка через Smithery
    1. Журнал изменений
      1. v0.2.0 (2025-04-17)
    2. Функции
      1. Предпосылки
        1. Быстрый старт (с использованием npx)
          1. Конфигурация
            1. Предоставленный инструмент MCP
              1. search_patents
            2. Разработка
              1. Ведение журнала
                1. Лицензия

                  Related MCP Servers

                  • A
                    security
                    A
                    license
                    A
                    quality
                    Provides web search capabilities using Google Custom Search API, enabling users to perform searches through a Model Context Protocol server.
                    Last updated -
                    2
                    209
                    17
                    JavaScript
                    MIT License
                    • Apple
                  • A
                    security
                    A
                    license
                    A
                    quality
                    A Model Context Protocol server that enables LLMs to perform web searches using Google's Custom Search API through a standardized interface.
                    Last updated -
                    1
                    7
                    TypeScript
                    MIT License
                  • -
                    security
                    F
                    license
                    -
                    quality
                    A Model Context Protocol server that enables LLMs to perform Google searches via the Serper API, allowing models to retrieve current information from the web.
                    Last updated -
                    1
                    Python
                  • A
                    security
                    F
                    license
                    A
                    quality
                    A Model Context Protocol server that provides web search capabilities using Google Custom Search API and webpage content extraction functionality.
                    Last updated -
                    2
                    0
                    1
                    JavaScript
                    • Apple

                  View all related MCP servers

                  ID: 9la1udawol