Для чего этот сервер?

Этот сервер подключает Grok к MCP-экосистеме. Он нужен, чтобы дать ассистентам вроде Claude доступ к Grok-моделям: чату с веб-поиском, генерации изображений и видео, анализу картинок и работе с документами. Разработчикам не придётся писать обвязку — сервер сам управляет контекстом, файлами, агентскими вызовами. Всё работает через стандартный MCP-протокол.

Каталог MCP
merterbak/Grok-MCP

merterbak/Grok-MCP

от merterbak

MCP-сервер для интеграции с xAI Grok: агентные вызовы инструментов (веб-поиск, выполнение кода), генерация изображений и видео, анализ изображений через зрение, работа с файлами и stateful-чаты с с...

Github NPM Сайт сервера

README

Инструменты и схема сервера

Версии

Установить сервер

Grok-MCP

MCP server for xAI’s Grok API with Web/X search, vision, image/video generation and file support.

Features

Agentic Tool Calling: Web search, X search, code execution, and image generation with multi-step reasoning
Multiple Grok Models: Access to latest models such as grok-4.6, grok-4.5, grok-build-0.1 and more
Image and Video Generation: Create images and videos using Grok Imagine
Vision Capabilities: Analyze images with Grok's vision models
Files API: Upload, manage, and chat with documents
Stateful Conversations: Maintain conversation context as id across multiple requests
Local Chat History: Option to save persistent client side chat history as JSON files in chats/

Prerequisites

Python 3.11 or higher
xAI API key (Get one here)
Astral UV

Installation

Clone the repository:

git clone https://github.com/merterbak/Grok-MCP.git
cd Grok-MCP

Create a venv environment:

uv venv
source .venv/bin/activate # macOS/Linux or .venv\Scripts\activate on Windows

Install dependencies:

uv sync

Configuration

Часто задаваемые вопросы

У этого сервера пока нет списка инструментов.

`2.0.0`основная	19.10.2026
`1.0.0`	11.10.2026
`2026.8.31`	31.08.2026
`2026.7.10`	10.07.2026
`2026.7.4`	05.07.2026
`2026.1.14`	14.01.2026
`2025.12.18`	18.12.2025
`2025.11.25`	25.11.2025
`2025.8.21`	21.08.2025
`2025.8.18`	18.08.2025
`2025.7.29`	31.07.2025
`2025.7.1`	01.07.2025
`2025.3.28`	28.03.2025
`2025.1.14`	14.01.2025
`0.6.2`	04.12.2024
`0.6.1`	03.12.2024
`0.6.0`	03.12.2024
`0.5.1`	25.11.2024
`0.5.0`	25.11.2024
`0.3.0`	22.11.2024
`0.2.0`	21.11.2024

Выберите клиент, чтобы установить merterbak/Grok-MCP:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "merterbak-grok-mcp-lo99wlp3s1": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/<your-username>/Desktop",
        "/Users/<your-username>/Downloads"
      ]
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "merterbak-grok-mcp-lo99wlp3s1": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/<your-username>/Desktop",
        "/Users/<your-username>/Downloads"
      ]
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "merterbak-grok-mcp-lo99wlp3s1": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/<your-username>/Desktop",
        "/Users/<your-username>/Downloads"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"merterbak-grok-mcp-lo99wlp3s1\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"@modelcontextprotocol/server-filesystem\",\"/Users/<your-username>/Desktop\",\"/Users/<your-username>/Downloads\"]}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "merterbak-grok-mcp-lo99wlp3s1": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/<your-username>/Desktop",
        "/Users/<your-username>/Downloads"
      ]
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add merterbak-grok-mcp-lo99wlp3s1 -- npx -y @modelcontextprotocol/server-filesystem /Users/<your-username>/Desktop /Users/<your-username>/Downloads

Либо через JSON-конфиг:

claude mcp add-json merterbak-grok-mcp-lo99wlp3s1 "{\"command\":\"npx\",\"args\":[\"-y\",\"@modelcontextprotocol/server-filesystem\",\"/Users/<your-username>/Desktop\",\"/Users/<your-username>/Downloads\"]}"

Codex

Добавьте сервер командой в терминале:

codex mcp add merterbak-grok-mcp-lo99wlp3s1 -- npx -y @modelcontextprotocol/server-filesystem /Users/<your-username>/Desktop /Users/<your-username>/Downloads

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.merterbak-grok-mcp-lo99wlp3s1]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "/Users/<your-username>/Desktop", "/Users/<your-username>/Downloads"]

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите merterbak/Grok-MCP, а в поле команды запуска — строку ниже:

npx -y @modelcontextprotocol/server-filesystem /Users/<your-username>/Desktop /Users/<your-username>/Downloads

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "merterbak-grok-mcp-lo99wlp3s1": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/<your-username>/Desktop",
        "/Users/<your-username>/Downloads"
      ]
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "merterbak-grok-mcp-lo99wlp3s1": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/<your-username>/Desktop",
        "/Users/<your-username>/Downloads"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например merterbak-grok-mcp-lo99wlp3s1.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: merterbak-grok-mcp-lo99wlp3s1
    command: npx
    args:
      - "-y"
      - "@modelcontextprotocol/server-filesystem"
      - "/Users/<your-username>/Desktop"
      - "/Users/<your-username>/Downloads"

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "merterbak-grok-mcp-lo99wlp3s1": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/<your-username>/Desktop",
        "/Users/<your-username>/Downloads"
      ]
    }
  }
}

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "@modelcontextprotocol/server-filesystem",
    "/Users/<your-username>/Desktop",
    "/Users/<your-username>/Downloads"
  ]
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx