Mcp Servidor de Google A Servidor Mcp Para Búsqueda Personalizada de Google y Lectura de Páginas Web

¿Qué es mcp-google-search?

El ### mcp-google-search es un repositorio público creado por el usuario ### adenot en GitHub. Este proyecto se centra en mejorar las capacidades de búsqueda dentro de Google, proporcionando potencialmente a los usuarios resultados y funcionalidades de búsqueda mejoradas. Está diseñado como una solución de código abierto, permitiendo a los desarrolladores contribuir y mejorar sus características.

Características de mcp-google-search

• Código Abierto: El repositorio es accesible públicamente, lo que permite a cualquiera ver, usar y contribuir al código.
• Funcionalidad de Búsqueda Mejorada: El proyecto tiene como objetivo mejorar la forma en que los usuarios interactúan con la búsqueda de Google, ofreciendo potencialmente características que agilizan el proceso de búsqueda.
• Impulsado por la Comunidad: Como un proyecto de código abierto, fomenta la colaboración entre desarrolladores, creando una comunidad que puede contribuir a su crecimiento y mejora.
• Documentación: Se proporciona documentación completa para ayudar a los usuarios a entender cómo implementar y utilizar las características del repositorio de manera efectiva.

Cómo Usar mcp-google-search

1. Clona el Repositorio: Comienza clonando el repositorio en tu máquina local usando el comando:

   git clone https://github.com/adenot/mcp-google-search.git
   

2. Instala Dependencias: Navega al directorio del proyecto e instala las dependencias necesarias. Esto se puede hacer típicamente usando gestores de paquetes como npm o yarn, dependiendo de la configuración del proyecto.

3. Ejecuta la Aplicación: Sigue las instrucciones en la documentación para ejecutar la aplicación. Esto puede implicar iniciar un servidor local o ejecutar scripts específicos.

4. Contribuye: Si deseas contribuir al proyecto, revisa las pautas de contribución proporcionadas en el repositorio. Puedes enviar problemas, solicitudes de características o incluso solicitudes de extracción con tus mejoras.

Preguntas Frecuentes

¿Qué lenguajes de programación se utilizan en mcp-google-search?

El proyecto utiliza principalmente JavaScript, pero también puede incluir HTML y CSS para el desarrollo front-end.

¿Cómo puedo reportar problemas o errores?

Puedes reportar problemas navegando a la pestaña "Issues" en el repositorio y enviando un nuevo problema con información detallada sobre el problema.

¿Hay una licencia para mcp-google-search?

Sí, el repositorio está licenciado bajo la Licencia MIT, que permite el uso, modificación y distribución gratuita del software.

¿Cómo puedo mantenerme actualizado sobre los cambios en el repositorio?

Puedes seguir el repositorio en GitHub para recibir notificaciones sobre actualizaciones, o puedes seguir el proyecto en plataformas de redes sociales si están disponibles.

¿Puedo contribuir al proyecto?

¡Absolutamente! Las contribuciones son bienvenidas. Por favor, consulta las pautas de contribución en el repositorio para obtener más información sobre cómo involucrarte.

mcp-google-server A MCP Server for Google Custom Search and Webpage Reading

A Model Context Protocol server that provides web search capabilities using Google Custom Search API and webpage content extraction functionality.

Setup

Getting Google API Key and Search Engine ID

1. Create a Google Cloud Project:

   • Go to Google Cloud Console
   • Create a new project or select an existing one
   • Enable billing for your project

2. Enable Custom Search API:

   • Go to API Library
   • Search for "Custom Search API"
   • Click "Enable"

3. Get API Key:

   • Go to Credentials
   • Click "Create Credentials" > "API Key"
   • Copy your API key
   • (Optional) Restrict the API key to only Custom Search API

4. Create Custom Search Engine:

   • Go to Programmable Search Engine
   • Enter the sites you want to search (use www.google.com for general web search)
   • Click "Create"
   • On the next page, click "Customize"
   • In the settings, enable "Search the entire web"
   • Copy your Search Engine ID (cx)

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Features

Search Tool

Perform web searches using Google Custom Search API:

• Search the entire web or specific sites
• Control number of results (1-10)
• Get structured results with title, link, and snippet

Webpage Reader Tool

Extract content from any webpage:

• Fetch and parse webpage content
• Extract page title and main text
• Clean content by removing scripts and styles
• Return structured data with title, text, and URL

Installation

Installing via Smithery

To install Google Custom Search Server for Claude Desktop automatically via Smithery:

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

To use with Claude Desktop, add the server config with your Google API credentials:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On 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"
      }
    }
  }
}

Usage

Search Tool

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

Webpage Reader Tool

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

Example response from webpage reader:

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

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.