GW X Research MCP

Это read-only MCP-инструмент для ChatGPT: GPT отвечает за диалог с вами и вторичный анализ, а Grok через x_search от xAI выполняет поиск по постам и тредам указанных X-блогеров.

Одношаговая установка на macOS + Codex

Требуются Node.js 20.6+, Codex CLI и действующий xAI API Key. Выполните одну команду ниже — установщик скроет ввод и проверит Key, установит сервис, настроит автозапуск и зарегистрирует его в Codex:

(tmp="$(mktemp)" && trap 'rm -f "$tmp"' EXIT && curl -fsSL --retry 3 -o "$tmp" https://raw.githubusercontent.com/wzh605574547gin/gw-x-research-mcp/a7606e567a8fedfb64126db3554ffdb4279ef2a7/install.sh && echo "b77d2ea593ab97496b00732d78b1877f2e9fd0970f11830e9a298f79a0cef7cb  $tmp" | shasum -a 256 -c - && bash "$tmp")

Установщик проверит собственную SHA-256 и подтвердит commit исходного кода, соответствующий v1.0.0. После установки перезапустите Codex и проверьте gw_x_research через /mcp. По умолчанию сервис слушает только 127.0.0.1, API Key хранится в локальном .env с правами 0600 и не попадает в конфигурацию Codex.

Если вы предпочитаете сначала изучить скрипт, откройте install.sh и только потом выполняйте команду выше. Одношаговый установщик v1.0.0 поддерживает только чистую установку; при наличии существующего каталога установки он безопасно завершит работу.

Related MCP server: mcp-x-intelligence

Что он умеет

• Ограничение 1–20 X-аккаунтами, без примешивания постов других блогеров.

• Поиск по теме и диапазону дат.

• Анализ изображений в твитах.

• Возврат исследовательского отчёта на китайском, ссылок на исходные посты и диапазона поиска.

• Не входит в ваш X-аккаунт, не публикует, не ставит лайки и не подписывается.

Примечание: x_search — это исследовательский поиск, он не эквивалентен полному экспорту истории аккаунта. Инструмент явно помечает результаты как не являющиеся исчерпывающим архивом.

Шаг 1: Подготовка xAI API Key

1. Откройте https://console.x.ai/.

2. Создайте API Key и пополните баланс API-аккаунта.

3. Не отправляйте Key в чат.

Шаг 2: Локальный запуск на Mac

Нужен Node.js 20.6 или новее. В терминале перейдите в этот каталог и выполните:

npm install
cp .env.example .env

Откройте .env и замените строку ниже на ваш реальный Key:

XAI_API_KEY=xai-your-api-key

При первом локальном тесте рекомендуется временно удалить или закомментировать MCP_ACCESS_TOKEN в .env, затем выполнить:

set -a
source .env
set +a
npm start

Откройте в браузере http://localhost:3000/health — если видите "ok":true, сервис запущен.

Шаг 3: Подключение к ChatGPT

Для личного использования рекомендуется Secure MCP Tunnel — так xAI Key остаётся на вашем Mac, без публичного сервера:

1. В веб-версии ChatGPT откройте «Настройки → Безопасность и вход → Режим разработчика».

2. Перейдите в ChatGPT Plugins и нажмите «плюс», чтобы создать подключение.

3. В Connection выберите Tunnel и укажите, чтобы Tunnel указывал на локальный http://localhost:3000/mcp.

4. В поле имени укажите GW X Research, после создания проверьте, появился ли в списке инструментов research_x_author.

5. Откройте новый диалог и выберите GW X Research через «+ → Developer mode».

Если в вашем аккаунте пока нет Secure MCP Tunnel, можно развернуть Docker-контейнер на платформе с поддержкой HTTPS; но при публичном развёртывании обязательны надёжная аутентификация и ограничение частоты запросов. Не выставляйте /mcp без аутентификации в открытый интернет и не записывайте XAI_API_KEY в код или Docker-образ.

Готовые шаблоны вопросов

只使用 GW X Research 的 research_x_author 工具。
检索 @博主账号 从 2026-01-01 到今天关于 AVGO 的原创分析推文和线程，深度选择 deep，最多20条。
然后由你做二次分析：
1. 按时间线还原观点变化；
2. 区分事实、推断和预测；
3. 提取最重要的多头与空头论据；
4. 检查前后矛盾；
5. 每项结论附原帖链接；
6. 明确说明搜索是否可能遗漏内容。

Входные параметры инструмента

Docker

docker build -t gw-x-research-mcp .
export MCP_ACCESS_TOKEN="$(openssl rand -hex 32)"
docker run --rm -p 3000:3000 \
  -e XAI_API_KEY="$XAI_API_KEY" \
  -e HOST=0.0.0.0 \
  -e MCP_ACCESS_TOKEN="$MCP_ACCESS_TOKEN" \
  gw-x-research-mcp

Если контейнер слушает не loopback-адрес, сервис будет принудительно требовать MCP_ACCESS_TOKEN. При пробросе портов дополнительно ограничьте доступ через межсетевой экран, HTTPS-обратный прокси или OAuth; не выставляйте неаутентифицированные конечные точки в открытый интернет.

Локальная проверка

npm run check
npm test

Удаление

При удалении сначала удалите gw_x_research из Codex, затем удалите LaunchAgent com.gwcapital.gw-x-research-mcp; после этого при необходимости удалите ~/.local/share/gw-x-research-mcp. .env содержит API Key — перед удалением убедитесь, что он больше не нужен.

Стоимость и безопасность

• xAI отдельно тарифицирует токены Grok и вызовы инструмента x_search.

• Сервер читает Key только из переменных окружения.

• MCP-инструмент помечен как read-only, но контент в X всё равно может содержать prompt-инъекции; окончательные выводы следует сверять со ссылками на исходные посты.

• При публичном развёртывании используйте стандартный OAuth, ChatGPT Secure MCP Tunnel или доверенный аутентифицирующий прокси. MCP_ACCESS_TOKEN предназначен только для клиентов с поддержкой Bearer Token или для тестирования прокси и не является полноценной схемой многофакторной аутентификации пользователей.