x-search-mcp

Ein schlanker stdio-MCP-Wrapper um das serverseitige x_search-Tool von xAI.

Der Server liest seine Upstream-Konfiguration aus Umgebungsvariablen und leitet jeden search-Aufruf an einen OpenAI/xAI-Responses-kompatiblen Endpunkt weiter. Er ist dafür ausgelegt, sowohl mit dem offiziellen xAI-Endpunkt als auch mit Middleware wie CLIProxyAPI zu funktionieren, die dasselbe Protokoll (Responses + x_search) implementiert.

MCP-Schnittstelle

• Servername: x-search

• Transport: stdio

• Tool: search

Tool-Argumente:

Für den Handle-Filter gibt es drei Optionen: keinen Filter (Standard), eine Allow-Liste oder eine Exclude-Liste. Die Angabe beider Listen wird abgelehnt.

Related MCP server: bluex-mcp

Umgebung

Der MCP-Client übergibt dem erzeugten Prozess genau drei Upstream-Einstellungen:

• XAI_BASE_URL — zum Beispiel https://api.x.ai/v1 oder eine OpenAI/xAI-kompatible Middleware-Basis-URL, die auf /v1 endet

• XAI_MODEL — zum Beispiel grok-4.6

• XAI_API_KEY — Bearer-Anmeldedaten, die vom konfigurierten Upstream akzeptiert werden

Die Implementierung verwendet ausschließlich die Responses-API. Sie sendet ein natives x_search-Tool und erzwingt die Tool-Nutzung mit tool_choice: "required".

Installation / Ausführung

Führen Sie für Clients, die stdio-MCP-Server unterstützen, den Server direkt von GitHub aus:

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

und geben Sie die drei Variablen in der env-Konfiguration dieses MCP-Servers an. Zum Beispiel:

{
  "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": "..."
  }
}

Entwicklung

npm install
npm run typecheck
npm test
npm run build

Verhalten

• Keine Kompatibilitätsschicht für Chat Completions.

• Keine Umschreibung von Ergebnissen oder Zitatbereinigung; der Ausgabetext von xAI/Middleware wird wie empfangen zurückgegeben.

• Nicht-2xx-Antwortkörper des Upstreams werden unverändert an den MCP-Client zurückgegeben.

• Kein HTTP-Server, keine Datenbank und kein dauerhafter Zustand.