Google Search — MCP-сервер для веб-поиска и чтения страниц

Сервер реализует протокол MCP (Model Context Protocol) и предоставляет два инструмента: поиск через Google Custom Search API и извлечение содержимого веб-страниц. Позволяет AI-агентам (например, Claude Desktop) выполнять поиск в интернете и читать страницы напрямую.

Возможности

• Поиск через Google Custom Search: поиск по всему интернету или конкретным сайтам, количество результатов от 1 до 10, возвращает заголовок, ссылку и сниппет.
• Чтение веб-страниц: загрузка HTML, очистка от скриптов и стилей, извлечение заголовка и основного текста.

Установка

Через Smithery (рекомендовано)

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

Вручную

1. Клонируйте репозиторий:

   git clone <repo-url>
   cd mcp-google-server
   

2. Установите зависимости и соберите:

   npm install
   npm run build
   

Получение ключей Google

1. API-ключ:

   • Перейдите в Google Cloud Console.
   • Создайте/выберите проект, включите биллинг.
   • В библиотеке API найдите и включите Custom Search API.
   • В разделе Credentials создайте API-ключ (можно ограничить только Custom Search API).

2. Search Engine ID (cx):

   • На странице Programmable Search Engine создайте новый поисковик.
   • Для общего веб-поиска укажите www.google.com в поле «сайты для поиска».
   • После создания в настройках включите опцию Search the entire web.
   • Скопируйте Search Engine ID (cx).

Конфигурация для Claude Desktop

Добавьте в файл конфигурации:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "google-search": {
      "command": "npx",
      "args": ["-y", "@adenot/mcp-google-search"],
      "env": {
        "GOOGLE_API_KEY": "ваш-api-ключ",
        "GOOGLE_SEARCH_ENGINE_ID": "ваш-search-engine-id"
      }
    }
  }
}

Использование

Поиск

{
  "name": "search",
  "arguments": {
    "query": "последние новости ИИ",
    "num": 5
  }
}

Параметр num — опциональный, по умолчанию 5, максимум 10.

Чтение страницы

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

Ответ содержит:

{
  "title": "Example Domain",
  "text": "...очищенный текст страницы...",
  "url": "https://example.com"
}

Разработка и отладка

• Запуск с авто-пересборкой: npm run watch
• Для отладки используйте MCP Inspector:

npm run inspector

После запуска откроется URL с интерфейсом отладки в браузере. Сервер общается через stdio, поэтому inspector помогает просматривать запросы и ответы.