x-search-mcp

一个围绕 xAI 服务端 x_search 工具的轻量级 stdio MCP 包装器。

该服务器从环境变量读取上游配置，并将每次 search 调用转发到兼容 OpenAI/xAI Responses 的端点。它既适用于官方 xAI 端点，也适用于实现相同 Responses + x_search 协议的中间件（如 CLIProxyAPI）。

MCP 接口

• 服务器名称：x-search

• 传输：stdio

• 工具：search

工具参数：

句柄过滤状态为以下三种之一：无过滤（默认）、允许列表或排除列表。同时提供两个列表会被拒绝。

Related MCP server: X Search MCP Server

环境

MCP 客户端会向生成的子进程提供恰好三个上游设置：

• XAI_BASE_URL — 例如 https://api.x.ai/v1，或一个以 /v1 结尾、兼容 OpenAI/xAI 的中间件基础 URL

• XAI_MODEL — 例如 grok-4.6

• XAI_API_KEY — 配置的上游所接受的 Bearer 凭据

该实现仅使用 Responses API。它会发送一个原生 x_search 工具，并通过 tool_choice: "required" 强制使用工具。

安装 / 运行

对于支持 stdio MCP 服务器的客户端，可以直接从 GitHub 运行：

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

并在该 MCP 服务器的 env 配置中提供这三个变量。例如：

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

开发

npm install
npm run typecheck
npm test
npm run build

行为

• 无 Chat Completions 兼容层。

• 不重写结果，也不做引用清理；xAI/中间件的输出文本将原样返回。

• 非 2xx 的上游响应体会原样返回给 MCP 客户端。

• 无 HTTP 服务器、数据库或持久化状态。