Skip to main content
Glama
Sign In
gramax-docportal-mcp

gramax-docportal-mcp

by mdemyanov
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

gramax-docportal-mcp

MCP-сервер для доступа к порталу документации Gramax. Позволяет искать статьи, получать контент и навигацию через Claude и другие LLM.

Инструменты

Инструмент

Описание

gramax_list_catalogs

Список всех каталогов документации

gramax_get_navigation

Дерево навигации каталога

gramax_search

Поиск по статьям (фильтры по свойствам, языку, семантический поиск)

gramax_get_article

Содержимое статьи в Markdown

Related MCP server: Dedalus MCP Documentation Server

Установка

uv tool install gramax-docportal-mcp

Настройка

Добавьте в .mcp.json:

{
  "mcpServers": {
    "gramax": {
      "command": "uvx",
      "args": ["gramax-docportal-mcp"],
      "env": {
        "GRAMAX_BASE_URL": "https://your-portal.example.com",
        "GRAMAX_API_TOKEN": "ваш-api-токен"
      }
    }
  }
}

Публичные порталы (без токена)

Если портал публичный (не требует авторизации), GRAMAX_API_TOKEN можно не задавать — сервер работает в анонимном режиме:

{
  "mcpServers": {
    "gramax": {
      "command": "uvx",
      "args": ["gramax-docportal-mcp"],
      "env": {
        "GRAMAX_BASE_URL": "https://your-portal.example.com"
      }
    }
  }
}

Получение токена

Если портал защищён, откройте в браузере (будучи залогиненным на портале):

https://your-portal.example.com/api/user/token

Токен действует 30 дней. Для кастомного срока:

https://your-portal.example.com/api/user/token?expiresAt=2026-12-31

Без токена или с истёкшим токеном сервер получит 401 при первом запросе и вернёт русскоязычное сообщение об ошибке.

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

Переменная

Описание

Обязательно

GRAMAX_BASE_URL

URL портала документации

Да

GRAMAX_API_TOKEN

API-токен (Bearer); не нужен для публичных порталов

Нет

GRAMAX_AI_TIMEOUT

Таймаут AI-поиска в секундах (по умолчанию 120)

Нет

GRAMAX_AI_ARTICLES_LANGUAGE

Язык статей в индексе для AI-поиска. Значения по умолчанию нет — см. предупреждение ниже

Нет

GRAMAX_AI_RESPONSE_LANGUAGE

Язык генерируемого ответа AI-поиска (по умолчанию ru)

Нет

Не задавайте GRAMAX_AI_ARTICLES_LANGUAGE без нужды. На некоторых порталах любое непустое значение этого параметра обнуляет выдачу: AI-поиск отвечает «не нашёл информации в предоставленной базе знаний» и не отдаёт ни одного источника, а полнотекстовый поиск возвращает ноль результатов вместо десятков. Поэтому с версии 0.3.3 значения по умолчанию у переменной нет и параметр не уходит на портал, пока его не задали явно. Задавайте его, только если ваш портал действительно требует фильтра по языку статей, и проверьте выдачу до и после. GRAMAX_AI_RESPONSE_LANGUAGE безвреден.

Расширенный поиск

gramax_search поддерживает дополнительные параметры для точной фильтрации:

Параметр

Описание

catalog_name

Ограничить поиск одним каталогом

search_type

"vector" — семантический поиск (по умолчанию — полнотекстовый)

language

Язык статей: "ru", "en", "de", "zh" и др. Уходит как articlesLanguage — на некоторых порталах обнуляет выдачу, по умолчанию не задавать

resource_filter

"without" — только статьи, "only" — только файлы

property_filter

Фильтр по свойствам статей (Продукт, Сегмент, Отрасль и др.)

Примеры property_filter

{"op": "eq", "key": "Продукт", "value": "NSD"}

{"op": "contains", "key": "Сегмент", "list": ["Enterprise", "SMB"]}

{"op": "and", "filters": [
  {"op": "eq", "key": "Тип контента", "value": "Кейс"},
  {"op": "eq", "key": "Отрасль", "value": "Логистика"}
]}

В результатах поиска отображаются метаданные статей (🏷️) и рекомендованные результаты (⭐).

Лицензия

MIT

Available Tools

5 tools
gramax_ai_searchA

AI-поиск по документации Gramax: связный ответ с ссылками на источники.

Использовать для вопросов в свободной форме, когда нужен сгенерированный ответ, а не список релевантных статей. Для списка результатов — gramax_search.

Args: query: Вопрос на естественном языке. catalog_name: Имя каталога для контекста (без него — по всем). articles_language: Язык статей в индексе ("ru", "en", ...). По умолчанию не задаётся: на некоторых порталах непустое значение обнуляет выдачу. Задать явно или через GRAMAX_AI_ARTICLES_LANGUAGE, если портал этого требует. response_language: Язык генерируемого ответа. По умолчанию — из GRAMAX_AI_RESPONSE_LANGUAGE (ru). current_article: ID текущей статьи как контекст ("catalog_id/path").

Inputs: query (required), catalog_name, current_article, articles_language, +1 more. Returns: result

gramax_get_articleA

Получить содержимое статьи в формате Markdown.

Args: catalog_id: ID каталога article_id: ID статьи (получить через gramax_get_navigation или gramax_search)

Inputs: article_id (required), catalog_id (required). Returns: result

gramax_get_navigationA

Получить дерево навигации каталога: разделы, статьи, ссылки.

Args: catalog_id: ID каталога (получить через gramax_list_catalogs)

Inputs: catalog_id (required). Returns: result

gramax_list_catalogsA

Получить список всех каталогов документации на портале Gramax.

Возвращает таблицу с названиями и ID каталогов.

Inputs: no named parameters. Returns: result

gramax_searchA

Поиск по статьям документации Gramax.

Args: query: Поисковый запрос (авто-раскладка RU/EN и транслитерация) catalog_name: Имя каталога для поиска (без него — поиск по всем каталогам) search_type: Тип поиска — "vector" для семантического, без значения — полнотекстовый language: Язык статей: "ru", "en", "es", "zh", "fr", "de", "ja" и др. ВНИМАНИЕ: на некоторых порталах непустое значение обнуляет выдачу (уходит как articlesLanguage). По умолчанию не задавать. resource_filter: Фильтр ресурсов: "without" — только статьи, "only" — только файлы, "with" — всё (по умолчанию) property_filter: Фильтр по свойствам статей. Примеры: {"op": "eq", "key": "Продукт", "value": "NSD"} {"op": "contains", "key": "Сегмент", "list": ["Enterprise", "SMB"]} {"op": "and", "filters": [ {"op": "eq", "key": "Тип контента", "value": "Кейс"}, {"op": "eq", "key": "Отрасль", "value": "Логистика"} ]}

Inputs: query (required), language, search_type, catalog_name, +2 more. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A4/5.0

    Scored across 5 tools

    Disambiguation3/5

    gramax_search and gramax_ai_search have overlapping purposes (both search documentation), though descriptions clarify the difference between list results and generated answers. Other tools are distinct, but the search overlap is a notable ambiguity.

    Naming Consistency5/5

    All tools follow a consistent gramax_verb_noun pattern (e.g., gramax_get_navigation, gramax_list_catalogs, gramax_search). The prefix is uniform and verbs are predictable.

    Tool Count5/5

    5 tools for a documentation portal is well-scoped: navigation, listing, search, AI search, and article retrieval cover common needs without bloat.

    Completeness4/5

    Core lifecycle for documentation access is covered: list catalogs, get navigation, search, and retrieve articles. However, there is no tool to create, update, or delete content, which might be expected in a full docportal MCP, but the surface is sufficient for read-only use.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers