Skip to main content
Glama
Sign In
enesjakozh

MCP Google Server

by adenot
npmGitHub
JavaScript
MIT License
94
6
  • Apple
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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.

Integrations

  • Allows performing web searches using Google Custom Search API, returning structured results with title, link, and snippet.

mcp-google-server Un servidor MCP para la búsqueda personalizada de Google y la lectura de páginas web

Un servidor de protocolo de contexto de modelo que proporciona capacidades de búsqueda web mediante la API de búsqueda personalizada de Google y la funcionalidad de extracción de contenido de páginas web.

Configuración

Obtener la clave API de Google y el ID del motor de búsqueda

  1. Crear un proyecto de Google Cloud:
  2. Habilitar API de búsqueda personalizada:
    • Ir a la biblioteca API
    • Buscar "API de búsqueda personalizada"
    • Haga clic en "Habilitar"
  3. Obtener clave API:
    • Ir a Credenciales
    • Haga clic en "Crear credenciales" > "Clave API".
    • Copia tu clave API
    • (Opcional) Restrinja la clave API solo a la API de búsqueda personalizada
  4. Crear un motor de búsqueda personalizado:
    • Ir al motor de búsqueda programable
    • Ingrese los sitios que desea buscar (use www.google.com para búsquedas web generales)
    • Haga clic en "Crear"
    • En la página siguiente, haga clic en "Personalizar".
    • En la configuración, activa "Buscar en toda la web".
    • Copia tu ID de motor de búsqueda (cx)

Desarrollo

Instalar dependencias:

npm install

Construir el servidor:

npm run build

Para desarrollo con reconstrucción automática:

npm run watch

Características

Herramienta de búsqueda

Realice búsquedas web utilizando la API de búsqueda personalizada de Google:

  • Busque en toda la web o en sitios específicos
  • Número de control de resultados (1-10)
  • Obtenga resultados estructurados con título, enlace y fragmento

Herramienta de lectura de páginas web

Extraer contenido de cualquier página web:

  • Obtener y analizar el contenido de la página web
  • Extraer el título de la página y el texto principal
  • Limpiar el contenido eliminando scripts y estilos
  • Devuelve datos estructurados con título, texto y URL

Instalación

Instalación mediante herrería

Para instalar Google Custom Search Server para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @adenot/mcp-google-search --client claude

Para usar con Claude Desktop, agregue la configuración del servidor con sus credenciales de API de Google:

En MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json En Windows: %APPDATA%/Claude/claude_desktop_config.json

{ "mcpServers": { "google-search": { "command": "npx", "args": [ "-y", "@adenot/mcp-google-search" ], "env": { "GOOGLE_API_KEY": "your-api-key-here", "GOOGLE_SEARCH_ENGINE_ID": "your-search-engine-id-here" } } } }

Uso

Herramienta de búsqueda

{ "name": "search", "arguments": { "query": "your search query", "num": 5 // optional, default is 5, max is 10 } }

Herramienta de lectura de páginas web

{ "name": "read_webpage", "arguments": { "url": "https://example.com" } }

Ejemplo de respuesta del lector de la página web:

{ "title": "Example Domain", "text": "Extracted and cleaned webpage content...", "url": "https://example.com" }

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser complicada. Recomendamos usar el Inspector MCP , disponible como script de paquete:

npm run inspector

El Inspector proporcionará una URL para acceder a las herramientas de depuración en su navegador.

You must be authenticated.

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

Tools

Proporciona capacidades de búsqueda web mediante la API de búsqueda personalizada de Google, lo que permite a los usuarios realizar búsquedas a través de un servidor de protocolo de contexto de modelo.

  1. Setup
    1. Getting Google API Key and Search Engine ID
  2. Development
    1. Features
      1. Search Tool
      2. Webpage Reader Tool
    2. Installation
      1. Installing via Smithery
    3. Usage
      1. Search Tool
      2. Webpage Reader Tool
      3. Debugging

    Related Resources

    Appeared in Searches

    ID: 05vc0lafp9