Реализация сервера Model Context Protocol (MCP), которая обеспечивает возможности поиска Google News через интеграцию SerpAPI. Автоматически категоризирует результаты новостей и поддерживает несколько языков и регионов.

https://github.com/user-attachments/assets/1cc71c27-f840-4c94-9ab5-460d84ba4779

✨ Особенности

🔍 Гибкие параметры поиска

Комплексные возможности поиска, включая поиск на основе запросов, поиск по темам, фильтрацию публикаций и освещение историй.

🌐 Глобальный охват

Поддерживает несколько языков и регионов с помощью настраиваемых кодов языка и страны.

📊 Умная категоризация

Автоматически классифицирует результаты поиска новостей по таким темам, как ИИ и технологии, бизнес, наука и исследования и здравоохранение.

🔀 Несколько типов результатов

Обрабатывает различные типы результатов поиска новостей, включая заголовки, статьи, связанные темы и ссылки меню.

🛠️ Надежная обработка ошибок

Комплексная обработка ошибок при сбоях API и недопустимых входных данных с полезными сообщениями об ошибках.

🌍 Поддержка языков

Автоматический возврат к английскому языку для неподдерживаемых языковых кодов с соответствующими уведомлениями для пользователя.

🔑 Руководство по настройке API SERP

Прежде чем начать, вам нужно получить ключ API SERP. Вот как это сделать:

1. Посетите сайт SERP API и создайте учетную запись.

2. После регистрации перейдите в свою панель управления:

   • Найдите раздел «Ключ API».

   • Скопируйте свой ключ API

   • Новые пользователи получают 100 бесплатных вызовов API

3. Подробности использования API:

   • Бесплатный уровень: 100 поисков в месяц

   • Платные планы начинаются от 50 долларов в месяц за 5000 поисков.

   • Выставление счетов на основе успешных вызовов API

   • Несколько способов оплаты: кредитная карта, PayPal и т. д.

4. Ограничения по использованию:

   • Скорость запросов: 2 запроса/секунду

   • Ограничения по IP: нет

   • Одновременные запросы: 5

   • Время кэширования ответа: 1 час

👩‍🔧 Решение проблем с подключением MCP-серверов с помощью NVM/NPM

Нажмите, чтобы просмотреть мое решение по конфигурации 👉 https://github.com/modelcontextprotocol/servers/issues/76

🚀 Быстрый старт

1. Установить зависимости:

npm install

2. Сборка сервера:

npm run build

3. Настройте среду: Измените файл claude_desktop_config.json следующим образом (измените пути в соответствии с вашей системой):

    "google-news": {
      "command": "D:\\Program\\nvm\\node.exe",
      "args": [
        "D:\\github_repository\\path_to\\dist\\index.js"
      ],
      "env": {
        "SERP_API_KEY": "your-api-key"
      }
    }

4. Запустите сервер:

npm start

Поиск неисправностей

1. Неверный ключ API

• Проверьте конфигурацию ключа API в claude_desktop_config.json

• Подтвердите, что ключ API активен на панели инструментов API SERP

2. Запросы с ошибками

• Проверьте сетевое подключение

• Убедитесь, что квота вызовов API не превышена.

• Проверить формат параметра запроса

Related MCP server: Google News13 MCP Server

Запуск оценок

Пакет evals загружает клиент mcp, который затем запускает файл index.ts, поэтому нет необходимости перестраиваться между тестами. Вы можете загрузить переменные среды, указав префикс команды npx. Полную документацию можно найти здесь .

OPENAI_API_KEY=your-key  npx mcp-eval src/evals/evals.ts src/index.ts

📦 Установка

Установка через Smithery

Чтобы автоматически установить Google News для Claude Desktop через Smithery :

npx -y @smithery/cli install @chanmeng666/google-news-server --client claude

Установка через mcp-get

npx @michaellatman/mcp-get@latest install @chanmeng666/google-news-server

Если вы используете старую версию Windows PowerShell, вам может потребоваться выполнить Set-ExecutionPolicy Bypass -Scope Process перед выполнением этой команды.

Ручная установка

@chanmeng666/google-news-server

# Using npm
npm i @chanmeng666/google-news-server
# or
npm install @chanmeng666/google-news-server

# Using yarn
yarn add @chanmeng666/google-news-server

# Using pnpm
pnpm add @chanmeng666/google-news-server

💻 Технологический стек

📖 API-документация

Сервер реализует протокол контекста модели и предоставляет инструмент поиска новостей Google со следующими параметрами:

• q : Строка поискового запроса

• gl : Код страны (например, «us», «uk»)

• hl : Код языка (например, «en», «es»)

• topic_token : Токен для определенных тем новостей

• publication_token : Токен для определенных издателей

• story_token : Токен для полного освещения истории

• section_token : Токен для определенных разделов

🔧 Развитие

# Run in development mode with hot reload
npm run dev

# Run linting
npm run lint

# Run tests
npm run test

📝 Лицензия

Этот проект имеет лицензию MIT .

🙋‍♀ Автор

Создано и поддерживается Чан Мэн .