Servidor MCP de patentes de Google ( google-patents-mcp )

Este proyecto proporciona un servidor de Protocolo de Contexto de Modelo (MCP) que permite buscar información de patentes de Google a través de la API de patentes de Google SerpApi .

Características

• Proporciona una herramienta MCP search_patents para buscar patentes de Google.
• Utiliza SerpApi como backend.
• Se puede ejecutar directamente usando npx sin instalación local.

Prerrequisitos

• Node.js: se recomienda la versión 18 o superior.
• npm: necesario para ejecutar el comando npx .
• Clave API de SerpApi: necesita una clave API válida de SerpApi para utilizar la API de patentes de Google.

Inicio rápido (usando npx)

La forma más sencilla de ejecutar este servidor es usar npx . Este comando descarga (si es necesario) y ejecuta el servidor directamente.

Nota: reemplace @kunihiros/google-patents-mcp con el nombre del paquete publicado real si es diferente.

El servidor se iniciará y escuchará las solicitudes MCP en la entrada/salida estándar.

Configuración

El servidor requiere tu clave API de SerpApi. Puedes proporcionarla de una de las siguientes maneras:

1. Variable de entorno (recomendada para hosts MCP): Configure la variable de entorno SERPAPI_API_KEY al ejecutar el servidor. Las configuraciones de host MCP suelen permitir configurar variables de entorno para los servidores.Ejemplo de fragmento de configuración del host MCP ( config.json o similar):
   { "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. Archivo .env: crea un archivo .env en el directorio donde ejecuta el comando npx (para pruebas locales o si no usa un host MCP), o en tu directorio de inicio ( ~/.google-patents-mcp.env ), con el siguiente contenido:
   SERPAPI_API_KEY=YOUR_ACTUAL_SERPAPI_KEY # Optional: Set log level (e.g., debug, info, warn, error) # LOG_LEVEL=debug
   Nota: Si bien usar un archivo .env es conveniente para pruebas locales, para producción o integración con hosts MCP, configurar la variable de entorno directamente a través de la configuración del host es el enfoque recomendado y más seguro. El principal caso de uso previsto es la ejecución mediante npx , donde las variables de entorno suelen ser administradas por el proceso de llamada o el host MCP.

El servidor busca archivos .env en el siguiente orden: * ./.env (relativo a dónde se ejecuta npx ) * ~/.google-patents-mcp.env (en su directorio de inicio)

Herramienta MCP proporcionada

search_patents

Busca patentes de Google a través de SerpApi.

Esquema de entrada:

Producción:

Devuelve un objeto JSON que contiene los resultados de búsqueda de SerpApi. La estructura sigue el formato de respuesta de SerpApi.

Ejemplo de uso (solicitud MCP):

Desarrollo

1. Clonar el repositorio (si es necesario para el desarrollo):
   # git clone <repository-url> # cd google-patents-mcp
2. Instalar dependencias:
   npm install
3. Cree un archivo .env : copie .env.example a .env y agregue su SERPAPI_API_KEY .
4. Construir:
   npm run build
5. Ejecutar localmente:
   npm start
   O para desarrollo con reconstrucción automática:
   npm run dev

Explotación florestal

• Los registros se envían al error estándar.
• El nivel de registro se puede controlar mediante la variable de entorno LOG_LEVEL ( error , warn , info , http , verbose , debug , silly ). El valor predeterminado es info .
• Se intenta crear un archivo de registro en la raíz del proyecto ( google-patents-server.log ), el directorio de inicio del usuario ( ~/.google-patents-server.log ) o /tmp/google-patents-server.log .

Licencia

Licencia MIT (Ver archivo LICENCIA)