gramax-docportal-mcp
MCP-сервер для доступа к порталу документации Gramax. Позволяет искать статьи, получать контент и навигацию через Claude и другие LLM.
Инструменты
| Инструмент | Описание |
|---|---|
gramax_list_catalogs |
Список всех каталогов документации |
gramax_get_navigation |
Дерево навигации каталога |
gramax_search |
Поиск по статьям (фильтры по свойствам, языку, семантический поиск) |
gramax_get_article |
Содержимое статьи в Markdown |
Установка
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
Metadata
Release files for gramax-docportal-mcp 0.3.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| gramax_docportal_mcp-0.3.4.tar.gz | 16.0 kB | Without provenance | Details for gramax_docportal_mcp-0.3.4.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| gramax_docportal_mcp-0.3.4-py3-none-any.whl | Python 3 | none | any | Details for gramax_docportal_mcp-0.3.4-py3-none-any.whl |
Total release size: 30.4 kB
Release files / gramax_docportal_mcp-0.3.4.tar.gz
| Download URL | gramax_docportal_mcp-0.3.4.tar.gz |
|---|---|
| Size | 16.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ec4cc8cb70bc051c5d3b0f4e115768a4bd2b0965b91f6328173f19d8c9e7e04a
|
|
BLAKE2b-256 checksum How to use checksums |
bd6eafb551d530337f984d75c292de957c067996f4a6a488347d5584728ff674
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / gramax_docportal_mcp-0.3.4-py3-none-any.whl
| Download URL | gramax_docportal_mcp-0.3.4-py3-none-any.whl |
|---|---|
| Size | 14.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0e07924a69ff451fb90509708bb4f8eac42cd5c3797fd6c5df34ba47911874c5
|
|
BLAKE2b-256 checksum How to use checksums |
8d61b5619b047af0e5f580f1dc09868553bcf9583850d422310aeadd5a645c51
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for gramax-docportal-mcp 0.3.4
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.