x-search-mcp

xAI のサーバーサイド x_search ツールをラップする、薄い stdio MCP ラッパーです。

このサーバーは環境変数からアップストリーム設定を読み取り、各 search 呼び出しを OpenAI/xAI Responses 互換エンドポイントに転送します。公式の xAI エンドポイントと、同じ Responses + x_search プロトコルを実装する CLIProxyAPI などのミドルウェアの両方で動作するように設計されています。

MCP インターフェース

• サーバー名: x-search

• トランスポート: stdio

• ツール: search

ツールの引数:

ハンドルフィルターの状態は、フィルターなし（デフォルト）、許可リスト、除外リストの 3 つのいずれかです。両方のリストを指定すると拒否されます。

Related MCP server: bluex-mcp

環境

MCP クライアントは、起動されたプロセスに正確に 3 つのアップストリーム設定を提供します:

• XAI_BASE_URL — 例: https://api.x.ai/v1、または /v1 で終わる OpenAI/xAI 互換ミドルウェアのベース URL

• XAI_MODEL — 例: grok-4.6

• XAI_API_KEY — 設定されたアップストリームが受け入れるベアラー認証情報

この実装は Responses API のみを使用します。1 つのネイティブ x_search ツールを送信し、tool_choice: "required" でツールの使用を強制します。

インストール / 実行

stdio MCP サーバーをサポートするクライアントでは、GitHub から直接実行します:

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

また、3 つの変数をその 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 サーバー、データベース、永続状態なし。