Grok-MCP

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

Возможности

Агентские инструменты: Поиск в интернете, поиск в X и выполнение кода с многошаговым рассуждением
Различные модели Grok: Доступ к новейшим моделям, таким как grok-4.20-0309-reasoning, grok-4-1-fast-reasoning и другим
Генерация изображений и видео: Создание изображений и видео с помощью Grok Imagine
Возможности зрения: Анализ изображений с помощью моделей зрения Grok
API файлов: Загрузка, управление и общение с документами
Диалоги с сохранением состояния: Поддержание контекста диалога в виде id между несколькими запросами
Локальная история чатов: Возможность сохранения постоянной истории чатов на стороне клиента в виде JSON-файлов в папке chats/

Related MCP server: Zen MCP Server

Предварительные требования

Python 3.11 или выше
API-ключ xAI (Получить можно здесь)
Astral UV

Установка

Клонируйте репозиторий:

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

Создайте виртуальное окружение (venv):

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

Установите зависимости:

uv sync

Конфигурация

Интеграция с Claude Desktop

Добавьте это в файл конфигурации Claude Desktop:

{
  "mcpServers": {
    "grok": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/Grok-MCP",
        "run",
        "python",
        "main.py"
      ],
      "env": {
        "XAI_API_KEY": "your_api_key_here"
      }
    }
  }
}

Интеграция с Claude Code

Выполните эту команду из директории проекта:

claude mcp add grok-mcp -e XAI_API_KEY=your_api_key_here -- uv run --directory /path/to/Grok-MCP python main.py

Или, если у вас есть файл .env с вашим ключом:

 claude mcp add grok-mcp -- uv run --directory /path/to/Grok-MCP python main.py

Проверьте регистрацию:

claude mcp list

Filesystem MCP (Опционально)

Claude Desktop не может отправлять загруженные изображения в чате в инструмент MCP. Самый простой способ предоставить доступ к файлам напрямую с вашего компьютера — это официальный MCP-сервер Filesystem. После его настройки вы сможете просто написать путь к файлу изображения (например, /Users/mert/Desktop/image.png) в чате, и Claude сможет использовать его с любым инструментом для работы с изображениями.

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

Для stdio:

uv run python main.py

Docker:

docker compose up --build

Mcp Inspector:

mcp dev main.py

Доступные инструменты

Каждый инструмент имеет полную документацию в src/server.py с описанием аргументов и формата возвращаемых данных. MCP-клиент отображает их напрямую, поэтому этот список — лишь краткий обзор доступных функций.

Примечание: Для использования изображений и файлов необходимо указывать пути в чате. См. Filesystem MCP (Опционально) для настройки.

Чат и рассуждения

chat — стандартное завершение чата с опциональной постоянной историей и поддержкой нескольких агентов.
chat_with_vision — анализ локальных или удаленных изображений с помощью модели зрения Grok.
chat_with_files — чат, основанный на ранее загруженных документах.
stateful_chat — продолжение диалога, сохраненного на стороне сервера, через response_id.
retrieve_stateful_response — получение сохраненного ответа по ID.
delete_stateful_response — удаление сохраненного ответа по ID.

Агентские инструменты

web_search — автономный веб-поиск с фильтрами доменов и цитированием.
x_search — автономный поиск по публикациям в X (Twitter) с фильтрами по пользователям и датам.
code_executor — решение задач путем выполнения Python в песочнице.
grok_agent — унифицированный агент, объединяющий файлы, изображения, веб-поиск, поиск в X и выполнение кода.

Изображения и видео

generate_image — создание или редактирование изображений с помощью Grok Imagine (поддерживается редактирование с несколькими референсами).
generate_video — преобразование текста в видео, изображения в видео или редактирование видео с помощью Grok Imagine.
extend_video — расширение существующего сгенерированного видео с помощью дополнительного промпта.

Файлы

upload_file — загрузка локального документа.
list_files — список загруженных файлов с сортировкой.
get_file — получение метаданных файла по ID.
get_file_content — скачивание содержимого файла в виде текста.
delete_file — удаление файла по ID.

Локальная история чатов

list_chat_sessions — список сохраненных сессий в chats/.
get_chat_history — получение полной расшифровки сессии.
clear_chat_history — удаление локального файла истории сессии.

Модели

list_models — список всех языковых и графических моделей Grok с актуальными ценами.

Лицензия

Этот проект является открытым и доступен по лицензии MIT.

Grok MCP