x-search-mcp

Un wrapper MCP stdio ligero alrededor de la herramienta x_search del lado del servidor de xAI.

El servidor lee su configuración upstream de las variables de entorno y reenvía cada llamada search a un endpoint compatible con Responses de OpenAI/xAI. Está diseñado para funcionar tanto con el endpoint oficial de xAI como con middleware como CLIProxyAPI que implementa el mismo protocolo Responses + x_search.

Interfaz MCP

• Nombre del servidor: x-search

• Transporte: stdio

• Herramienta: search

Argumentos de la herramienta:

El estado del filtro de handles es una de tres opciones: sin filtro (predeterminado), una lista de permitidos o una lista de excluidos. Proporcionar ambas listas se rechaza.

Related MCP server: bluex-mcp

Entorno

El cliente MCP proporciona exactamente tres ajustes upstream al proceso iniciado:

• XAI_BASE_URL — por ejemplo https://api.x.ai/v1 o una URL base de middleware compatible con OpenAI/xAI que termine en /v1

• XAI_MODEL — por ejemplo grok-4.6

• XAI_API_KEY — credencial de tipo bearer aceptada por el upstream configurado

La implementación solo usa la API de Responses. Envía una herramienta x_search nativa y fuerza el uso de la herramienta con tool_choice: "required".

Instalación / ejecución

Para clientes que admitan servidores MCP stdio, ejecuta directamente desde GitHub:

npx -y github:sandlong/x-search-mcp

y proporciona las tres variables en la configuración env de ese servidor MCP. Por ejemplo:

{
  "command": "npx",
  "args": ["-y", "github:sandlong/x-search-mcp"],
  "env": {
    "XAI_BASE_URL": "https://api.x.ai/v1",
    "XAI_MODEL": "grok-4.6",
    "XAI_API_KEY": "..."
  }
}

Desarrollo

npm install
npm run typecheck
npm test
npm run build

Comportamiento

• Sin capa de compatibilidad con Chat Completions.

• Sin reescritura de resultados ni limpieza de citas; el texto de salida de xAI/middleware se devuelve tal como se recibe.

• Los cuerpos de respuesta upstream no-2xx se devuelven al cliente MCP tal cual.

• Sin servidor HTTP, base de datos ni estado persistente.