GIMS Automation MCP Server

MCP (Model Context Protocol) сервер для интеграции coding-агентов (Claude Code CLI и др.) с системой GIMS Automation.

Возможности

Разработка сценариев автоматизации (Scripts)
Разработка типов источников данных (MultyDataSourceType) с методами и свойствами
Разработка типов активаторов (ActivatorType) с кодом и свойствами
Поиск по коду и имени
Автоматическое обновление токена доступа при истечении срока действия

Установка

Из GitLab

pip install git+ssh://git@gitlab.gelarm.ru/gelarm/gims-automation-mcp-server.git

Из GitHub

pip install git+https://github.com/gelarm/gims-automation-mcp-server.git

Документация

Инструкции для LLM агентов

Для разработки

git clone git@gitlab.gelarm.ru:gelarm/gims-automation-mcp-server.git
cd gims-automation-mcp-server
pip install -e ".[dev]"

Справка

gims-mcp-server --help

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

Claude Code CLI

Создайте файл .mcp.json в корне вашего проекта:

{
  "mcpServers": {
    "gims-automation": {
      "command": "gims-mcp-server",
      "env": {
        "GIMS_URL": "https://gims.example.com",
        "GIMS_ACCESS_TOKEN": "<JWT_ACCESS_TOKEN>",
        "GIMS_REFRESH_TOKEN": "<JWT_REFRESH_TOKEN>"
      }
    }
  }
}

Self-signed сертификаты

Для работы с серверами с самоподписанными сертификатами добавьте GIMS_VERIFY_SSL:

{
  "mcpServers": {
    "gims-automation": {
      "command": "gims-mcp-server",
      "env": {
        "GIMS_URL": "https://gims.example.com",
        "GIMS_ACCESS_TOKEN": "<JWT_ACCESS_TOKEN>",
        "GIMS_REFRESH_TOKEN": "<JWT_REFRESH_TOKEN>",
        "GIMS_VERIFY_SSL": "false"
      }
    }
  }
}

Параметры

| Параметр | CLI | Env | Описание | |----------|-----|-----|----------| | URL | --url | GIMS_URL | URL GIMS сервера | | Access Token | --access-token | GIMS_ACCESS_TOKEN | JWT токен доступа | | Refresh Token | --refresh-token | GIMS_REFRESH_TOKEN | JWT токен обновления | | Verify SSL | --verify-ssl | GIMS_VERIFY_SSL | Проверка SSL сертификата (по умолчанию: true) | | Max Response Size | --max-response-size | GIMS_MAX_RESPONSE_SIZE_KB | Лимит размера ответа в КБ (по умолчанию: 10). Примерный пересчёт в токены: 1КБ ≈ 250 токенов (ASCII) или 170 токенов (кириллица) | | Log Stream Timeout | --log-stream-timeout | GIMS_LOG_STREAM_TIMEOUT | Таймаут для SSE-потока логов в секундах (по умолчанию: 60) |

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

Войдите в GIMS через веб-интерфейс
Откройте Developer Tools → Application → Cookies
Скопируйте значения access_token и refresh_token

Автоматическое обновление токена

MCP сервер автоматически обновляет access token при получении ошибки 401 (токен истёк). Для этого используется refresh token.

При недействительном refresh token выводится сообщение: `` Ошибка аутентификации: токен обновления недействителен. Проверьте учётную запись и получите новые токены в GIMS. ``

Доступные Tools (57)

Scripts (11 tools)

| Tool | Описание | |------|----------| | list_script_folders | Список папок скриптов с иерархией | | create_script_folder | Создать папку | | update_script_folder | Обновить папку | | delete_script_folder | Удалить папку | | list_scripts | Список скриптов (с фильтром по папке) | | get_script | Получить скрипт с кодом | | create_script | Создать скрипт | | update_script | Обновить скрипт | | delete_script | Удалить скрипт | | search_scripts | Поиск по коду и/или имени | | get_script_execution_log | Получить лог выполнения скрипта через SSE-поток. Ожидает маркер завершения или таймаут. Параметры: scr_id (обязательный) — ID скрипта; timeout (опционально) — таймаут в секундах; end_markers (опционально) — маркеры завершения (по умолчанию: ['END SCRIPT']); filter_pattern (опционально) — regex для фильтрации строк; keep_timestamp (опционально) — сохранять timestamp и уровень лога (по умолчанию: false) |

DataSource Types (22 tools)

Папки (4 tools)

| Tool | Описание | |------|----------| | list_datasource_type_folders | Список папок типов ИД | | create_datasource_type_folder | Создать папку | | update_datasource_type_folder | Обновить папку | | delete_datasource_type_folder | Удалить папку |

Типы (5 tools)

| Tool | Описание | |------|----------| | list_datasource_types | Список типов ИД | | get_datasource_type | Получить тип с properties и methods | | create_datasource_type | Создать тип | | update_datasource_type | Обновить тип | | delete_datasource_type | Удалить тип |

Свойства (4 tools)

| Tool | Описание | |------|----------| | list_datasource_type_properties | Список свойств типа | | create_datasource_type_property | Добавить свойство | | update_datasource_type_property | Обновить свойство | | delete_datasource_type_property | Удалить свойство |

Методы (4 tools)

| Tool | Описание | |------|----------| | list_datasource_type_methods | Список методов типа | | create_datasource_type_method | Добавить метод | | update_datasource_type_method | Обновить метод (включая код) | | delete_datasource_type_method | Удалить метод |

Параметры методов (4 tools)

| Tool | Описание | |------|----------| | list_method_parameters | Список параметров метода | | create_method_parameter | Добавить параметр | | update_method_parameter | Обновить параметр | | delete_method_parameter | Удалить параметр |

Поиск (1 tool)

| Tool | Описание | |------|----------| | search_datasource_type_code | Поиск по коду методов |

Activator Types (14 tools)

Папки (4 tools)

| Tool | Описание | |------|----------| | list_activator_type_folders | Список папок типов активаторов | | create_activator_type_folder | Создать папку | | update_activator_type_folder | Обновить папку | | delete_activator_type_folder | Удалить папку |

Типы (5 tools)

| Tool | Описание | |------|----------| | list_activator_types | Список типов активаторов | | get_activator_type | Получить тип с кодом и properties | | create_activator_type | Создать тип | | update_activator_type | Обновить тип (включая код) | | delete_activator_type | Удалить тип |

Свойства (4 tools)

| Tool | Описание | |------|----------| | list_activator_type_properties | Список свойств типа | | create_activator_type_property | Добавить свойство | | update_activator_type_property | Обновить свойство | | delete_activator_type_property | Удалить свойство |

Поиск (1 tool)

| Tool | Описание | |------|----------| | search_activator_type_code | Поиск по коду типов |

Справочники (2 tools)

| Tool | Описание | |------|----------| | list_value_types | Типы значений (только чтение) | | list_property_sections | Разделы свойств (только чтение) |

Git Sync (8 tools)

Tools для синхронизации компонентов автоматизации с Git-репозиторием.

Экспорт (3 tools)

| Tool | Описание | |------|----------| | export_script | Экспорт скрипта в Git-формат (meta.yaml + code.py) | | export_datasource_type | Экспорт типа ИД со всеми методами и свойствами | | export_activator_type | Экспорт типа активатора со свойствами и кодом |

Импорт (3 tools)

| Tool | Описание | |------|----------| | import_script | Импорт скрипта с валидацией Python синтаксиса | | import_datasource_type | Импорт типа ИД | | import_activator_type | Импорт типа активатора |

Вспомогательные (2 tools)

| Tool | Описание | |------|----------| | validate_python_code | Проверка синтаксиса Python через ast.parse() | | compare_with_git | Сравнение версии в GIMS с Git (по updated_at/exported_at) |

Структура Git-репозитория

automation-components/
├── scripts/
│   └── <script_folder>/
│       ├── meta.yaml
│       └── code.py
├── datasource_types/
│   └── <type_folder>/
│       ├── meta.yaml
│       ├── properties.yaml
│       └── methods/
│           └── <method_label>/
│               ├── meta.yaml
│               ├── code.py
│               └── params.yaml
└── activator_types/
    └── <type_folder>/
        ├── meta.yaml
        ├── code.py
        └── properties.yaml

Git-операции

Git-операции выполняются через Bash tool (не через MCP):

git config user.name   # Проверить конфигурацию перед commit
git config user.email
git pull origin main
git add scripts/my_script/
git commit -m "Export script 'My Script'"
git push origin main

Разработка

Запуск тестов

pytest

Линтинг

ruff check src tests

Покрытие тестами

pytest --cov=gims_mcp --cov-report=term-missing

Лицензия

MIT

GIMS Automation MCP Server