Skip to main content
Glama
gelarm

GIMS Automation MCP Server

by gelarm

GIMS Automation MCP Server

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

Возможности

  • Разработка сценариев автоматизации (Scripts)

  • Разработка типов источников данных (MultyDataSourceType) с методами и свойствами

  • Разработка типов активаторов (ActivatorType) с кодом и свойствами

  • Поиск по коду и имени

  • Автоматическое обновление токена доступа при истечении срока действия

Related MCP server: agent-services-mcp

Установка

Из 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

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

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

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)

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

  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

A
license - permissive license
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/gelarm/gims-automation-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server