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: 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 서버, 데이터베이스 또는 영구 상태가 없습니다.