Repository hosting for the MCP server code, accessed through cloning for installation.
Supported as a web retriever option for the quick_search tool, allowing search queries through Google's search engine.
Integrates with OpenAI's API for powering the research functionality, requiring an API key for operation.
🔍 Сервер MCP исследователя GPT
Почему GPT Researcher MCP?
В то время как приложения LLM могут получать доступ к инструментам веб-поиска с помощью MCP, GPT Researcher MCP обеспечивает глубокие результаты исследований. Стандартные инструменты поиска возвращают необработанные результаты, требующие ручной фильтрации, часто содержащие нерелевантные источники и тратящие пространство контекстного окна.
GPT Researcher автономно исследует и проверяет многочисленные источники, фокусируясь только на релевантной, надежной и актуальной информации. Хотя он немного медленнее стандартного поиска (ожидание около 30 секунд), он обеспечивает:
- ✨ Более качественная информация
- 📊 Оптимизированное использование контекста
- 🔎 Комплексные результаты
- 🧠 Лучшее обоснование для LLM
💻 Демонстрация рабочего стола Клода
https://github.com/user-attachments/assets/ef97eea5-a409-42b9-8f6d-b82ab16c52a8
Ресурсы
research_resource
: Получить веб-ресурсы, связанные с заданной задачей, с помощью исследования.
Основные инструменты
deep_research
: выполняет глубокое веб-исследование по теме, находя наиболее надежную и релевантную информацию.quick_search
: Выполняет быстрый поиск в Интернете, оптимизированный для скорости, а не качества, возвращая результаты поиска с фрагментами. Поддерживает любой поддерживаемый GPTR веб-извлекатель, такой как Tavily, Bing, Google и т. д... Узнайте больше здесьwrite_report
: Создать отчет на основе результатов исследованияget_research_sources
: Получить источники, использованные в исследованииget_research_context
: Получить полный контекст исследования
Подсказки
research_query
: Создать запрос на исследовательский запрос
Предпосылки
Перед запуском сервера MCP убедитесь, что у вас есть:
- Установлен Python 3.11 или выше
- Важно : GPT Researcher >=0.12.16 требует Python 3.11+
- API-ключи для сервисов, которые вы планируете использовать:
⚙️ Установка
- Клонируйте репозиторий GPT Researcher:
- Установите зависимости gptr-mcp:
- Настройте переменные среды:
- Скопируйте файл
.env.example
, чтобы создать новый файл с именем.env
: GXP3 - Отредактируйте файл
.env
, добавьте свои ключи API и настройте другие параметры: GXP4
- Скопируйте файл
Вы также можете добавить любую другую переменную окружения для конфигурации GPT Researcher.
🚀 Запуск сервера MCP
Запустить сервер MCP можно несколькими способами:
Метод 1: Непосредственное использование Python
Метод 2: Использование MCP CLI (если установлен)
Метод 3: Использование Docker (рекомендуется для производства)
Вариант А: Автономный режим
Это самый простой способ запустить сервер, если вам не нужно подключаться к другим контейнерам:
Вариант B: С сетью для интеграции n8n
Если вам необходимо подключиться к другим сервисам, например n8n, в той же сети:
Примечание : Образ Docker использует Python 3.11 для соответствия требованиям gpt-researcher >=0.12.16. Если вы столкнулись с ошибками во время сборки, убедитесь, что вы используете последнюю версию Dockerfile из этого репозитория.
После запуска сервера вы увидите вывод, указывающий на то, что сервер готов принимать соединения. Вы можете проверить его работу следующим образом:
- Доступ к документации OpenAPI по адресу http://localhost:8000/docs
- Тестирование конечной точки MCP по адресу http://localhost:8000/mcp
Интеграция с Клодом
Вы можете интегрировать свой MCP-сервер с Claude, используя:
Интеграция с Claude Desktop — для использования с приложением Claude Desktop на Mac
Подробные инструкции можно найти по ссылке выше.
💻 Интеграция с рабочим столом Клода
Чтобы интегрировать локально работающий сервер MCP с Claude для Mac, вам необходимо:
- Убедитесь, что сервер MCP установлен и работает.
- Настройте рабочий стол Claude:
- Найдите или создайте файл конфигурации в
~/Library/Application Support/Claude/claude_desktop_config.json
- Добавьте ваш локальный сервер GPT Researcher MCP в конфигурацию
- Перезапустите Claude, чтобы применить конфигурацию.
- Найдите или создайте файл конфигурации в
Полные пошаговые инструкции см. в руководстве по интеграции Claude Desktop .
📝 Пример использования с Клодом
🔧 Устранение неполадок
Если у вас возникли проблемы при работе сервера MCP:
- Убедитесь, что ваши ключи API правильно установлены в файле
.env
- Убедитесь, что вы используете Python 3.11 или выше (требуется для gpt-researcher >=0.12.16)
- Убедитесь, что все зависимости установлены правильно.
- Проверьте журналы сервера на наличие сообщений об ошибках.
Если вы работаете с Docker и столкнулись с проблемами:
- Убедитесь, что контейнер запущен:
docker ps | grep gpt-mcp-server
- Проверьте логи контейнера:
docker logs gpt-mcp-server
- Убедитесь, что сервер привязан ко всем интерфейсам — журналы должны показывать прослушивание на 0.0.0.0:8000.
- Если во время сборки вы видите ошибки зависимостей:
- Убедитесь, что вы используете обновленный Dockerfile с Python 3.11
- Попробуйте выполнить пересборку с флагом
--no-cache
:docker build --no-cache -t gpt-mcp-server .
- Проверьте, соответствует ли версия gpt-researcher в файле requirements.txt версии Python.
По вопросам локальной установки:
👣 Дальнейшие шаги
- Изучите документацию по протоколу MCP, чтобы лучше понять, как интегрироваться с Claude.
- Узнайте об основных функциях GPT Researcher, которые расширят ваши исследовательские возможности.
- Ознакомьтесь с руководством по расширенному использованию для получения дополнительных параметров конфигурации.
📄 Лицензия
Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE.
📞 Поддержка / Контакты
- Сообщество Discord
- Электронная почта: assaf.elovic@gmail.com
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Расширяет возможности приложений LLM с помощью глубоких автономных возможностей веб-исследования, предоставляя более качественную информацию, чем стандартные инструменты поиска, путем изучения и проверки многочисленных надежных источников.
Related MCP Servers
- AsecurityAlicenseAqualityIntegrates Tavily's search API with LLMs to provide advanced web search capabilities, including intelligent result summaries, domain filtering for quality control, and configurable search parameters.Last updated -3649JavaScriptMIT License
- -securityFlicense-qualityEnables LLMs to perform sophisticated web searches through proxy servers using Tavily's API, supporting comprehensive web searches, direct question answering, and recent news article retrieval with AI-extracted content.Last updated -1Python
- -securityAlicense-qualityProvides AI-powered web search capabilities using Tavily's search API, enabling LLMs to perform sophisticated web searches, get direct answers to questions, and search recent news articles.Last updated -53PythonMIT License
- -securityAlicense-qualityEnables LLMs to autonomously retrieve and explore web content by fetching pages and recursively following links to a specified depth, particularly useful for learning about topics from documentation.Last updated -TypeScriptMIT License