Mcp Google Server A Mcp Server Per Google Ricerca Personalizzata E Lettura Di Pagine Web

Che cos'è mcp-google-search?

Il ### mcp-google-search è un repository pubblico creato dall'utente ### adenot su GitHub. Questo progetto si concentra sul miglioramento delle capacità di ricerca all'interno di Google, potenzialmente fornendo agli utenti risultati di ricerca e funzionalità migliorate. È progettato per essere una soluzione open-source, consentendo agli sviluppatori di contribuire e migliorare le sue caratteristiche.

Caratteristiche di mcp-google-search

• Open Source: Il repository è accessibile pubblicamente, consentendo a chiunque di visualizzare, utilizzare e contribuire al codice.
• Funzionalità di Ricerca Migliorate: Il progetto mira a migliorare il modo in cui gli utenti interagiscono con la ricerca di Google, offrendo potenzialmente funzionalità che semplificano il processo di ricerca.
• Guidato dalla Comunità: Essendo un progetto open-source, incoraggia la collaborazione tra sviluppatori, favorendo una comunità che può contribuire alla sua crescita e miglioramento.
• Documentazione: È fornita una documentazione completa per aiutare gli utenti a comprendere come implementare e utilizzare efficacemente le funzionalità del repository.

Come Utilizzare mcp-google-search

1. Clona il Repository: Inizia clonando il repository sulla tua macchina locale utilizzando il comando:

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

2. Installa le Dipendenze: Naviga nella directory del progetto e installa eventuali dipendenze necessarie. Questo può generalmente essere fatto utilizzando gestori di pacchetti come npm o yarn, a seconda della configurazione del progetto.

3. Esegui l'Applicazione: Segui le istruzioni nella documentazione per eseguire l'applicazione. Questo può comportare l'avvio di un server locale o l'esecuzione di script specifici.

4. Contribuisci: Se desideri contribuire al progetto, controlla le linee guida per i contributi fornite nel repository. Puoi inviare problemi, richieste di funzionalità o anche pull request con i tuoi miglioramenti.

Domande Frequenti

Quali linguaggi di programmazione sono utilizzati in mcp-google-search?

Il progetto utilizza principalmente JavaScript, ma può includere anche HTML e CSS per lo sviluppo front-end.

Come posso segnalare problemi o bug?

Puoi segnalare problemi navigando nella scheda "Issues" nel repository e inviando un nuovo problema con informazioni dettagliate sul problema.

C'è una licenza per mcp-google-search?

Sì, il repository è concesso in licenza sotto la Licenza MIT, che consente l'uso, la modifica e la distribuzione gratuita del software.

Come posso rimanere aggiornato sulle modifiche al repository?

Puoi seguire il repository su GitHub per ricevere notifiche sugli aggiornamenti, oppure puoi seguire il progetto su piattaforme di social media se disponibili.

Posso contribuire al progetto?

Assolutamente! I contributi sono benvenuti. Si prega di fare riferimento alle linee guida per i contributi nel repository per ulteriori informazioni su come partecipare.

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.