x-search-mcp

Тонкая stdio MCP-обёртка вокруг серверного инструмента x_search от xAI.

Сервер читает конфигурацию вышестоящего сервиса из переменных окружения и перенаправляет каждый вызов search на конечную точку, совместимую с OpenAI/xAI Responses. Он рассчитан на работу как с официальной конечной точкой xAI, так и с промежуточным ПО, например CLIProxyAPI, реализующим тот же протокол Responses + x_search.

Интерфейс MCP

• Имя сервера: x-search

• Транспорт: stdio

• Инструмент: search

Аргументы инструмента:

Состояние фильтра по X-аккаунтам может быть одним из трёх: без фильтра (по умолчанию), список разрешённых или список исключённых. Передача обоих списков отклоняется.

Related MCP server: bluex-mcp

Переменные окружения

MCP-клиент передаёт запущенному процессу ровно три параметра вышестоящего сервиса:

• XAI_BASE_URL — например https://api.x.ai/v1 или базовый URL совместимого с OpenAI/xAI промежуточного ПО, оканчивающийся на /v1

• 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

и укажите три переменные в конфигурации env этого MCP-сервера. Например:

{
  "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-сервера, базы данных или постоянного состояния.