GIMS Automation Server

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

Возможности

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

Установка

Из GitLab

pip install git+ssh://[email protected]/gelarm/gims-automation-mcp-server.git

Из GitHub

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

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

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

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

git clone [email protected]: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)

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

1. Войдите в GIMS через веб-интерфейс
2. Откройте Developer Tools → Application → Cookies
3. Скопируйте значения 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