GW X Research MCP

Esta es una herramienta MCP de solo lectura para ChatGPT: GPT se encarga de conversar contigo y hacer análisis secundarios, mientras que Grok utiliza x_search de xAI para recuperar publicaciones e hilos de bloggers específicos de X.

Instalación con un solo clic en macOS + Codex

Se requiere Node.js 20.6+, Codex CLI y una API Key válida de xAI. Ejecuta el siguiente comando; el instalador ocultará la entrada, verificará la clave, instalará el servicio, configurará el inicio automático y lo registrará en 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")

El instalador verificará su propio SHA-256 y validará el commit de código correspondiente a v1.0.0. Tras la instalación, reinicia Codex y comprueba gw_x_research con /mcp. Por defecto, solo escucha en 127.0.0.1; la API Key se guarda en el archivo .env local con permisos 0600 y no se escribe en la configuración de Codex.

Si prefieres revisar el script antes de ejecutarlo, abre primero install.sh y, después de confirmar, ejecuta el comando anterior. El instalador de un clic de v1.0.0 solo admite instalaciones nuevas; si el directorio de instalación ya existe, saldrá de forma segura.

Related MCP server: mcp-x-intelligence

Qué puede hacer

• Limita la búsqueda a 1–20 cuentas de X, sin mezclar publicaciones de otros bloggers.

• Busca por tema, fecha de inicio y fecha de fin.

• Puede analizar imágenes dentro de las publicaciones.

• Devuelve informes de investigación en chino, enlaces a las publicaciones originales y el rango de búsqueda.

• No inicia sesión en tu cuenta de X, no publica, no da "me gusta" ni sigue a nadie.

Nota: x_search es una búsqueda de tipo investigación, no equivale a una exportación completa del historial de la cuenta. La herramienta marcará explícitamente que los resultados no son un archivo exhaustivo.

Paso 1: Preparar la API Key de xAI

1. Abre https://console.x.ai/.

2. Crea una API Key y recarga la cuenta de la API.

3. No envíes la Key en el chat.

Paso 2: Iniciar localmente en Mac

Se requiere Node.js 20.6 o una versión posterior. En la terminal, entra en este directorio y ejecuta:

npm install
cp .env.example .env

Abre .env y cambia la siguiente línea por tu Key real:

XAI_API_KEY=xai-your-api-key

En la primera prueba local, se recomienda comentar o eliminar temporalmente MCP_ACCESS_TOKEN del .env y luego ejecutar:

set -a
source .env
set +a
npm start

Abre el navegador y visita http://localhost:3000/health; si ves "ok":true, el servicio se ha iniciado correctamente.

Paso 3: Conectar con ChatGPT

Para uso personal, se recomienda Secure MCP Tunnel, de modo que la Key de xAI permanezca en tu Mac y no necesites un servidor público:

1. En la versión web de ChatGPT, abre "Configuración → Seguridad e inicio de sesión → Modo desarrollador".

2. Ve a ChatGPT Plugins y haz clic en el signo más para crear una conexión.

3. En Connection, selecciona Tunnel y haz que el túnel apunte a http://localhost:3000/mcp de tu máquina.

4. En Nombre, escribe GW X Research; tras crearla, comprueba si aparece research_x_author en la lista de herramientas.

5. Abre una nueva conversación, selecciona GW X Research desde "+ → Modo desarrollador".

Si tu cuenta aún no tiene Secure MCP Tunnel, también puedes implementar el contenedor Docker en una plataforma compatible con HTTPS; pero en implementaciones públicas es obligatorio añadir autenticación y limitación de velocidad fiables. No expongas /mcp sin autenticación a Internet pública y no escribas XAI_API_KEY en el código ni en la imagen Docker.

Plantilla de pregunta lista para usar

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

Entradas de la herramienta

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

Cuando el contenedor no escucha en la dirección de bucle local, el servicio exigirá MCP_ACCESS_TOKEN. Si se mapean puertos, añade además firewall, proxy inverso HTTPS o control de acceso OAuth; no expongas el endpoint sin autenticación a Internet pública.

Comprobación local

npm run check
npm test

Desinstalación

Para desinstalar, primero elimina gw_x_research de Codex, después desinstala el LaunchAgent com.gwcapital.gw-research-mcp y, por último, borra ~/.local/share/gw-x-research-mcp según sea necesario. En .env se encuentra la API Key; asegúrate de que ya no la necesitas antes de eliminarla.

Coste y seguridad

• xAI factura por separado los tokens de Grok y las llamadas a la herramienta x_search.

• El servidor solo lee la Key desde las variables de entorno.

• La herramienta MCP está marcada como de solo lectura, pero el contenido de X puede contener inyecciones de prompt; las conclusiones finales deben basarse siempre en los enlaces a las publicaciones originales.

• Si se implementa en Internet pública, utiliza OAuth estándar, Secure MCP Tunnel de ChatGPT o un proxy de autenticación de confianza. MCP_ACCESS_TOKEN solo sirve para clientes o pruebas con soporte Bearer Token; no es una solución completa de autenticación multiusuario.