Skip to main content
Glama
x-search
by sandlong

x-search-mcp

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

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

MCP 接口

  • 服务器名称:x-search

  • 传输:stdio

  • 工具:search

工具参数:

字段

必填

默认值

说明

query

是

—

对 Grok 的搜索请求

allowed_x_handles

否

省略

最多 20 个;与 excluded_x_handles 互斥

excluded_x_handles

否

省略

最多 20 个;与 allowed_x_handles 互斥

from_date

否

省略

包含当日,格式为 YYYY-MM-DD

to_date

否

省略

包含当日,格式为 YYYY-MM-DD

enable_image_understanding

否

true

传递给原生 x_search

enable_video_understanding

否

true

传递给原生 x_search

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

Related MCP server: bluex-mcp

环境

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 服务器、数据库或持久化状态。

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables searching X (Twitter) posts, discussions, trends, and web content via Grok API using natural language.
      3
      16 npm
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      MCP server for live X/Twitter and web search, driven by your locally logged-in Grok CLI and leveraging your X Premium or SuperGrok subscription quota.
      3
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Provides read-only access to X (Twitter) search via xAI's Responses API, returning Grok-generated answers with citations from posts, profiles, and threads.
      1
      MIT