Mcp Google Server A Mcp Server Para Pesquisa Personalizada do Google e Leitura de Páginas da Web

O que é mcp-google-search?

O ### mcp-google-search é um repositório público criado pelo usuário ### adenot no GitHub. Este projeto se concentra em aprimorar as capacidades de busca dentro do Google, potencialmente fornecendo aos usuários resultados de busca e funcionalidades melhoradas. Ele foi projetado para ser uma solução de código aberto, permitindo que desenvolvedores contribuam e aprimorem suas características.

Recursos do mcp-google-search

• Código Aberto: O repositório é acessível publicamente, permitindo que qualquer pessoa visualize, use e contribua para o código.
• Funcionalidade de Busca Aprimorada: O projeto visa melhorar a forma como os usuários interagem com a busca do Google, potencialmente oferecendo recursos que simplificam o processo de busca.
• Comunidade Colaborativa: Como um projeto de código aberto, ele incentiva a colaboração entre desenvolvedores, promovendo uma comunidade que pode contribuir para seu crescimento e melhoria.
• Documentação: Documentação abrangente é fornecida para ajudar os usuários a entender como implementar e utilizar as funcionalidades do repositório de forma eficaz.

Como Usar o mcp-google-search

1. Clone o Repositório: Comece clonando o repositório para sua máquina local usando o comando:

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

2. Instale Dependências: Navegue até o diretório do projeto e instale quaisquer dependências necessárias. Isso pode ser feito normalmente usando gerenciadores de pacotes como npm ou yarn, dependendo da configuração do projeto.

3. Execute o Aplicativo: Siga as instruções na documentação para executar o aplicativo. Isso pode envolver iniciar um servidor local ou executar scripts específicos.

4. Contribua: Se você deseja contribuir para o projeto, verifique as diretrizes de contribuição fornecidas no repositório. Você pode enviar problemas, solicitações de recursos ou até mesmo pull requests com suas melhorias.

Perguntas Frequentes

Quais linguagens de programação são usadas no mcp-google-search?

O projeto utiliza principalmente JavaScript, mas também pode incluir HTML e CSS para desenvolvimento front-end.

Como posso relatar problemas ou bugs?

Você pode relatar problemas navegando até a aba "Issues" no repositório e enviando um novo problema com informações detalhadas sobre o problema.

Existe uma licença para o mcp-google-search?

Sim, o repositório é licenciado sob a Licença MIT, que permite o uso, modificação e distribuição gratuita do software.

Como posso me manter atualizado sobre as mudanças no repositório?

Você pode acompanhar o repositório no GitHub para receber notificações sobre atualizações, ou pode seguir o projeto em plataformas de mídia social, se disponível.

Posso contribuir para o projeto?

Absolutamente! Contribuições são bem-vindas. Por favor, consulte as diretrizes de contribuição no repositório para mais informações sobre como se envolver.

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.