MCP 服务器

mcp-grok-search

Enables AI assistants to search the internet using Grok's built-in web browsing capabilities, with configurable effort levels and model selection.

README

mcp-grok-search

English | 中文

English

An MCP (Model Context Protocol) server that provides real-time web search capabilities via the Grok API. Enables AI assistants like Claude to search the internet through Grok's built-in web browsing.

Features

Real-time web search powered by Grok AI
Uses the Responses API, which is the recommended path for Grok web search
grok_web_search supports an optional efforts preset: low, medium, or high
efforts=low uses grok-4.20-reasoning
efforts=medium/high use grok-4.20-multi-agent with official reasoning presets
Configurable API endpoint, model, and timeout
Stdio transport for seamless MCP integration

Quick Start

Prerequisites

Node.js >= 18
A Grok API key (get one at x.ai)

Install & Build

git clone https://github.com/Cedriccmh/mcp-grok-search.git
cd mcp-grok-search
npm install
npm run build

Environment Variables

Variable	Description	Default
`GROK_API_KEY`	(Required) Your Grok API key	—
`GROK_API_URL`	API endpoint URL	`https://api.x.ai/v1/chat/completions`
`GROK_MODEL`	Default model used when `efforts` is not passed	`grok-4.20-reasoning`
`GROK_TIMEOUT_MS`	Request timeout in ms	`180000`

Run

GROK_API_KEY=your-key-here npm start

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "grok-web-search": {
      "command": "node",
      "args": ["path/to/mcp-grok-search/dist/index.js"],
      "env": {
        "GROK_API_KEY": "your-key-here"
      }
    }
  }
}

Tech Stack

TypeScript
@modelcontextprotocol/sdk — MCP server framework
Zod — Input schema validation

License

MIT

中文

一个基于 Grok API 的 MCP（Model Context Protocol）服务器，提供实时网络搜索能力。让 Claude 等 AI 助手能够通过 Grok 内置的网页浏览功能搜索互联网。

特性

基于 Grok AI 的实时网络搜索
使用 Responses API，符合 Grok 当前推荐的搜索接入方式
grok_web_search 工具支持可选的 efforts 预设：low、medium、high
efforts=low 使用 grok-4.20-reasoning
efforts=medium/high 使用 grok-4.20-multi-agent 和官方推荐的 reasoning.effort
可配置 API 端点、模型和超时时间
Stdio 传输，无缝对接 MCP 协议

快速开始

前置要求

Node.js >= 18
Grok API 密钥（在 x.ai 获取）

安装与构建

git clone https://github.com/Cedriccmh/mcp-grok-search.git
cd mcp-grok-search
npm install
npm run build

环境变量

变量	说明	默认值
`GROK_API_KEY`	（必填） Grok API 密钥	—
`GROK_API_URL`	API 端点 URL	`https://api.x.ai/v1/chat/completions`
`GROK_MODEL`	不传 `efforts` 时使用的默认模型	`grok-4.20-reasoning`
`GROK_TIMEOUT_MS`	请求超时时间（毫秒）	`180000`

运行

GROK_API_KEY=your-key-here npm start

Claude Desktop 配置

将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "grok-web-search": {
      "command": "node",
      "args": ["path/to/mcp-grok-search/dist/index.js"],
      "env": {
        "GROK_API_KEY": "your-key-here"
      }
    }
  }
}