🔍 Gigaplexity MCP

Gigaplexity MCP — MCP-сервер, который превращает GigaChat в поисковый инструмент: можно быстро получать ответы из интернета, запускать глубокие исследования и пошаговое рассуждение.

Работает в MCP-совместимых клиентах (например, VS Code Copilot, Claude Desktop и других).

Содержание

• Возможности

• Быстрый старт

• Использование

• Вложения файлов

• Переменные окружения

• Локальная разработка

• Для контрибьюторов

• Как это работает

• Архитектура

• Отказ от ответственности

• Лицензия

Related MCP server: Gemini Research MCP Server

Возможности

Быстрый старт

1) Получите cookie GigaChat

Нужна одна строка cookie из браузера. Войдите в giga.chat, откройте DevTools (F12) и выполните шаги:

1. Откройте вкладку Network.

2. Отправьте любое сообщение в чат.

3. Найдите запрос к https://giga.chat/api/giga-back-web/api/v0/sessions/request.

4. В Headers найдите заголовок Cookie.

5. Скопируйте полное значение (_sm_sess=...; _sm_user_id=...; ...).

Токен _sm_sess обычно короткоживущий, а полная актуальная cookie-строка чаще работает стабильнее. user_id берётся автоматически из JWT, project_id — автоматически через profile API.

2) Добавьте сервер в конфиг MCP-клиента

{
  "mcpServers": {
    "gigaplexity": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/alexsvdk/gigaplexity-mcp@stable",
        "gigaplexity-mcp"
      ],
      "env": {
        "GIGACHAT_COOKIES": "_sm_sess=eyJ...; _sm_user_id=2a4a...; sticky_cookie_dp=..."
      }
    }
  }
}

3) Задайте первый запрос

• «Найди последние изменения в Python 3.13» → ask

• «Что в этом PDF?» (с файлом) → ask + file_paths

• «Опиши это изображение» (с файлом) → ask + file_paths

• «Сделай исследование по time-series базам данных» → research

• «Пошагово объясни, почему трансформеры эффективны» → reason

Использование

Инструменты сервера:

• ask(query, file_paths?)

• research(query, domains?, extended?)

• reason(query)

Если вы используете вложения, передавайте абсолютные пути к локальным файлам.

Вложения файлов

ask поддерживает вложения через file_paths.

Поддерживаемые категории:

• Документы: pdf, docx, doc, pptx, ppt, xlsx, xls, epub, txt, html и файлы кода (py, js, ts и т.д.)

• Изображения: jpg, jpeg, png, webp, heic, heif, bmp

• Аудио: mp3, aac, m4a, opus, wav, ogg

Переменные окружения

* Нужна либо GIGACHAT_COOKIES (рекомендуется), либо GIGACHAT_SM_SESS. Приоритет у GIGACHAT_COOKIES.

Локальная разработка

git clone https://github.com/alexsvdk/gigaplexity-mcp
cd gigaplexity-mcp

python3 -m venv .venv
source .venv/bin/activate
pip install -e .
pip install pytest pytest-asyncio

# Юнит-тесты
pytest

# Интеграционные тесты (нужны валидные credentials)
export GIGACHAT_COOKIES="..."
pytest -m integration -s

Для контрибьюторов

Если вы хотите помочь проекту, начните с этих документов:

• CONTRIBUTING.md — процесс вклада и требования к PR

• SECURITY.md — как безопасно сообщать об уязвимостях

• CHANGELOG.md — формат и история изменений

• .github/pull_request_template.md — шаблон Pull Request

• .github/ISSUE_TEMPLATE/bug_report.md — шаблон bug report

• .github/ISSUE_TEMPLATE/feature_request.md — шаблон feature request

• .github/ISSUE_TEMPLATE/question.md — шаблон вопроса

• docs/STYLEGUIDE.md — единые правила документации

Как это работает

flowchart TD
    A[MCP client] --> B[gigaplexity-mcp]
    B --> C[Auth via cookies/JWT]
    C --> D[Preflight: GET /api/check + JWT exp]
    D --> E[Request to GigaChat API]
    E --> F[SSE stream parsing]
    F --> G[Markdown result with citations]

Базовый поток:

1. Аутентификация через cookie/токен браузерной сессии.

2. Preflight при первом обращении: локально проверяется exp JWT (с запасом GIGACHAT_PREFLIGHT_SKEW секунд), затем — GET /api/check. Если токен истёк, MCP-сервер сразу возвращает AuthExpiredError с понятной инструкцией по обновлению cookie.

3. Отправка запроса в режим ask, research или reason.

4. Парсинг SSE-стрима и сбор полного ответа.

5. Форматирование в удобный markdown (включая ссылки на источники).

Используемые режимы моделей:

• Ask: GigaChat-3-Ultra + web search

• Research: GigaChat-3-Ultra + deep research agent

• Reason: GigaChat-2-Reasoning + chain-of-thought режим

Архитектура

Подробности по протоколу и внутренним решениям: ARCHITECTURE.md.

Отказ от ответственности

1. Личное использование: проект ориентирован на private/local self-hosting.

2. Риск блокировки: неофициальная автоматизация может нарушать условия сервиса GigaChat.

3. Без гарантий: ПО поставляется по лицензии MIT «как есть», без ответственности автора за последствия использования.

Лицензия

MIT

Для связи: пишите в телеграм @a1ex5.