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

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

Related MCP server: Gemini Search MCP

中文

一个基于 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=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"
      }
    }
  }
}

技术栈

• TypeScript

• @modelcontextprotocol/sdk — MCP 服务端框架

• Zod — 输入参数校验

许可证

MIT