Mcp Serveur Google Un Serveur Mcp Pour la Recherche Personnalisée Google Et la Lecture de Pages Web

Qu'est-ce que mcp-google-search ?

Le ### mcp-google-search est un dépôt public créé par l'utilisateur ### adenot sur GitHub. Ce projet se concentre sur l'amélioration des capacités de recherche au sein de Google, offrant potentiellement aux utilisateurs des résultats de recherche et des fonctionnalités améliorés. Il est conçu comme une solution open-source, permettant aux développeurs de contribuer et d'améliorer ses fonctionnalités.

Fonctionnalités de mcp-google-search

• Open Source : Le dépôt est accessible au public, permettant à quiconque de voir, d'utiliser et de contribuer au code.
• Fonctionnalité de Recherche Améliorée : Le projet vise à améliorer la manière dont les utilisateurs interagissent avec la recherche Google, offrant potentiellement des fonctionnalités qui rationalisent le processus de recherche.
• Piloté par la Communauté : En tant que projet open-source, il encourage la collaboration entre développeurs, favorisant une communauté qui peut contribuer à sa croissance et à son amélioration.
• Documentation : Une documentation complète est fournie pour aider les utilisateurs à comprendre comment mettre en œuvre et utiliser efficacement les fonctionnalités du dépôt.

Comment utiliser mcp-google-search

1. Cloner le Dépôt : Commencez par cloner le dépôt sur votre machine locale en utilisant la commande :

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

2. Installer les Dépendances : Naviguez vers le répertoire du projet et installez les dépendances nécessaires. Cela peut généralement être fait en utilisant des gestionnaires de paquets comme npm ou yarn, selon la configuration du projet.

3. Exécuter l'Application : Suivez les instructions dans la documentation pour exécuter l'application. Cela peut impliquer de démarrer un serveur local ou d'exécuter des scripts spécifiques.

4. Contribuer : Si vous souhaitez contribuer au projet, consultez les directives de contribution fournies dans le dépôt. Vous pouvez soumettre des problèmes, des demandes de fonctionnalités ou même des demandes de tirage avec vos améliorations.

Questions Fréquemment Posées

Quels langages de programmation sont utilisés dans mcp-google-search ?

Le projet utilise principalement JavaScript, mais il peut également inclure HTML et CSS pour le développement front-end.

Comment puis-je signaler des problèmes ou des bogues ?

Vous pouvez signaler des problèmes en naviguant vers l'onglet "Issues" dans le dépôt et en soumettant un nouveau problème avec des informations détaillées sur le problème.

Y a-t-il une licence pour mcp-google-search ?

Oui, le dépôt est sous licence MIT, ce qui permet une utilisation, une modification et une distribution gratuites du logiciel.

Comment puis-je rester informé des changements dans le dépôt ?

Vous pouvez suivre le dépôt sur GitHub pour recevoir des notifications sur les mises à jour, ou vous pouvez suivre le projet sur les plateformes de médias sociaux si disponible.

Puis-je contribuer au projet ?

Absolument ! Les contributions sont les bienvenues. Veuillez consulter les directives de contribution dans le dépôt pour plus d'informations sur la façon de vous impliquer.

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.