mcp-grok-search

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"
      }
    }
  }
}

技术栈

• TypeScript
• @modelcontextprotocol/sdk — MCP 服务端框架
• Zod — 输入参数校验

许可证

MIT