GIMS Automation MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@GIMS Automation MCP Server list all scripts in the Automation folder"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 сервера |
Access Token |
|
| JWT токен доступа |
Refresh Token |
|
| JWT токен обновления |
Verify SSL |
|
| Проверка SSL сертификата (по умолчанию: true) |
Max Response Size |
|
| Лимит размера ответа в КБ (по умолчанию: 10). Примерный пересчёт в токены: 1КБ ≈ 250 токенов (ASCII) или 170 токенов (кириллица) |
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 | Описание |
| Список папок скриптов с иерархией |
| Создать папку |
| Обновить папку |
| Удалить папку |
| Список скриптов (с фильтром по папке) |
| Получить скрипт с кодом |
| Создать скрипт |
| Обновить скрипт |
| Удалить скрипт |
| Поиск по коду и/или имени |
| Получить лог выполнения скрипта через SSE-поток. Ожидает маркер завершения или таймаут. Параметры: |
DataSource Types (22 tools)
Папки (4 tools)
Tool | Описание |
| Список папок типов ИД |
| Создать папку |
| Обновить папку |
| Удалить папку |
Типы (5 tools)
Tool | Описание |
| Список типов ИД |
| Получить тип с properties и methods |
| Создать тип |
| Обновить тип |
| Удалить тип |
Свойства (4 tools)
Tool | Описание |
| Список свойств типа |
| Добавить свойство |
| Обновить свойство |
| Удалить свойство |
Методы (4 tools)
Tool | Описание |
| Список методов типа |
| Добавить метод |
| Обновить метод (включая код) |
| Удалить метод |
Параметры методов (4 tools)
Tool | Описание |
| Список параметров метода |
| Добавить параметр |
| Обновить параметр |
| Удалить параметр |
Поиск (1 tool)
Tool | Описание |
| Поиск по коду методов |
Activator Types (14 tools)
Папки (4 tools)
Tool | Описание |
| Список папок типов активаторов |
| Создать папку |
| Обновить папку |
| Удалить папку |
Типы (5 tools)
Tool | Описание |
| Список типов активаторов |
| Получить тип с кодом и properties |
| Создать тип |
| Обновить тип (включая код) |
| Удалить тип |
Свойства (4 tools)
Tool | Описание |
| Список свойств типа |
| Добавить свойство |
| Обновить свойство |
| Удалить свойство |
Поиск (1 tool)
Tool | Описание |
| Поиск по коду типов |
Справочники (2 tools)
Tool | Описание |
| Типы значений (только чтение) |
| Разделы свойств (только чтение) |
Git Sync (8 tools)
Tools для синхронизации компонентов автоматизации с Git-репозиторием.
Экспорт (3 tools)
Tool | Описание |
| Экспорт скрипта в Git-формат (meta.yaml + code.py) |
| Экспорт типа ИД со всеми методами и свойствами |
| Экспорт типа активатора со свойствами и кодом |
Импорт (3 tools)
Tool | Описание |
| Импорт скрипта с валидацией Python синтаксиса |
| Импорт типа ИД |
| Импорт типа активатора |
Вспомогательные (2 tools)
Tool | Описание |
| Проверка синтаксиса Python через ast.parse() |
| Сравнение версии в 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.yamlGit-операции
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
Available Tools
61 toolscompare_with_gitA
Compare a GIMS component with its Git version (by updated_at)
Inputs: gims_name (required), component_type (required), git_exported_at (required).
create_activator_typeC
Create a new activator type
Inputs: name (required), code, version, folder_id, +1 more.
create_activator_type_folderC
Create a new activator type folder
Inputs: name (required), parent_folder_id.
create_activator_type_propertyA
Create a new property for an activator type. Property is accessed in activator code directly by label name (NOT through self).
Inputs: name (required), label (required), value_type_id (required), section_name_id (required), +6 more.
create_datasource_typeC
Create a new datasource type
Inputs: name (required), version, folder_id, description.
create_datasource_type_folderB
Create a new datasource type folder
Inputs: name (required), parent_folder_id.
create_datasource_type_methodB
Create a new method for a datasource type
Inputs: name (required), label (required), mds_type_id (required), code, +1 more.
create_datasource_type_propertyA
Create a new property for a datasource type. Property is accessed in method code via self.property_label
Inputs: name (required), label (required), mds_type_id (required), value_type_id (required), +6 more.
create_method_parameterA
Create input or output parameter for a datasource type method. Input parameters (input_type=true) are passed when calling the method. Output parameters (input_type=false) are returned as dict from the method.
Inputs: label (required), method_id (required), value_type_id (required), is_hidden, +4 more.
create_scriptC
Create a new script
Inputs: name (required), code, folder_id.
create_script_folderB
Create a new script folder
Inputs: name (required), parent_folder_id.
delete_activator_typeB
Delete an activator type
Inputs: type_id (required).
delete_activator_type_folderC
Delete an activator type folder
Inputs: folder_id (required).
delete_activator_type_propertyB
Delete an activator type property
Inputs: property_id (required).
delete_datasource_typeB
Delete a datasource type
Inputs: type_id (required).
delete_datasource_type_folderC
Delete a datasource type folder
Inputs: folder_id (required).
delete_datasource_type_methodC
Delete a datasource type method
Inputs: method_id (required).
delete_datasource_type_propertyB
Delete a datasource type property
Inputs: property_id (required).
delete_method_parameterB
Delete a method parameter
Inputs: parameter_id (required).
delete_scriptC
Delete a script
Inputs: script_id (required).
delete_script_folderC
Delete a script folder
Inputs: folder_id (required).
export_activator_typeB
Export an activator type with properties and code
Inputs: type_id, type_name.
export_datasource_typeB
Export a datasource type with all properties and methods
Inputs: type_id, type_name.
export_scriptA
Export a script from GIMS to Git format (meta.yaml + code.py)
Inputs: script_id, script_name.
get_activator_typeA
Get activator type metadata. Code is filtered by default - use get_activator_type_code to retrieve code.
Inputs: type_id (required), include_properties.
get_activator_type_codeA
Get the full code of an activator type. Use this when you need to read or analyze the activator code.
Inputs: type_id (required).
get_datasource_typeA
Get a datasource type. Use include_properties=false and include_methods=false to get only basic type info (useful when full response is too large)
Inputs: type_id (required), include_methods, include_properties.
get_datasource_type_methodA
Get method metadata and parameters. Code is filtered - use get_datasource_type_method_code to retrieve code.
Inputs: method_id (required).
get_datasource_type_method_codeA
Get the full code of a datasource type method. Use this when you need to read or analyze the method code.
Inputs: method_id (required).
get_scriptA
Get script metadata by ID. Code is filtered by default - use get_script_code to retrieve code.
Inputs: script_id (required).
get_script_codeA
Get the full code of a script by ID. Use this when you need to read or analyze the script code.
Inputs: script_id (required).
get_script_execution_logA
Get script execution log via SSE stream. Waits for end marker or timeout. Use this to collect script output after manual script execution in GIMS.
Inputs: scr_id (required), timeout, end_markers, filter_pattern, +1 more.
import_activator_typeC
Import an activator type from Git format
Inputs: files (required), target_name, update_existing.
import_datasource_typeB
Import a datasource type from Git format
Inputs: files (required), target_name, update_existing.
import_scriptA
Import a script to GIMS from Git format. Validates Python syntax before import.
Inputs: code (required), meta_yaml (required), target_name, update_existing, +1 more.
list_activator_type_foldersA
List all activator type folders with their hierarchy paths
Inputs: no named parameters.
list_activator_type_propertiesB
List all properties of an activator type
Inputs: activator_type_id (required).
list_activator_typesA
List all activator types
Inputs: no named parameters.
list_datasource_type_foldersA
List all datasource type folders with their hierarchy paths
Inputs: no named parameters.
list_datasource_type_methodsA
List all methods of a datasource type (without code, use get_datasource_type_method for full code)
Inputs: mds_type_id (required).
list_datasource_type_propertiesB
List all properties of a datasource type
Inputs: mds_type_id (required).
list_datasource_typesA
List all datasource types
Inputs: no named parameters.
list_method_parametersA
List all parameters of a method
Inputs: method_id (required).
list_property_sectionsA
List all available property sections. Use this to get section_name_id when creating properties.
Inputs: no named parameters.
list_script_foldersA
List all script folders with their hierarchy paths
Inputs: no named parameters.
list_scriptsA
List all scripts with their folder paths
Inputs: folder_id.
list_value_typesA
List all available value types for properties and parameters. Use this to get value_type_id when creating properties.
Inputs: no named parameters.
search_activator_typesA
Search activator types by name and/or code. Default searches by name only.
Inputs: query (required), search_in, case_sensitive.
search_datasource_typesA
Search datasource types by name and/or method code. Default searches by name only.
Inputs: query (required), search_in, case_sensitive.
search_scriptsA
Search scripts by name and/or code content. Default searches by name only.
Inputs: query (required), search_in, case_sensitive.
update_activator_typeB
Update an activator type (including its code)
Inputs: type_id (required), code, name, version, +2 more.
update_activator_type_folderD
Update an activator type folder
Inputs: folder_id (required), name, parent_folder_id.
update_activator_type_propertyC
Update an activator type property
Inputs: property_id (required), name, label, is_hidden, +3 more.
update_datasource_typeC
Update a datasource type
Inputs: type_id (required), name, version, folder_id, +1 more.
update_datasource_type_folderC
Update a datasource type folder
Inputs: folder_id (required), name, parent_folder_id.
update_datasource_type_methodB
Update a datasource type method (including its code)
Inputs: method_id (required), code, name, label, +1 more.
update_datasource_type_propertyC
Update a datasource type property
Inputs: property_id (required), name, label, is_hidden, +3 more.
update_method_parameterD
Update a method parameter
Inputs: parameter_id (required), label, is_hidden, description, +1 more.
update_scriptC
Update an existing script
Inputs: script_id (required), code, name, folder_id.
update_script_folderC
Update an existing script folder
Inputs: folder_id (required), name, parent_folder_id.
validate_python_codeB
Validate Python code syntax using ast.parse()
Inputs: code (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 61 tools
Every tool targets a specific entity and action with clear prefixes. Similar tools like get_script and get_script_code are explicitly differentiated in descriptions. No overlapping purposes found.
All tools follow a consistent snake_case verb_noun pattern (e.g., create_script_folder, list_datasource_types). Multi-word nouns like datasource_type_method still fit the pattern. Minor deviation like compare_with_git is still readable.
At 61 tools, this is far beyond the '25+' threshold and falls into the extreme category. While the server covers many entity types, the sheer number may overwhelm agents and increase selection error rates.
The surface provides full CRUD for scripts, datasource types (with properties/methods/parameters), and activator types (with properties), plus search, export/import, and validation. The only notable gap is the lack of a tool to execute scripts directly, as execution log retrieval suggests manual execution.
Related MCP Connectors
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
MCP server for secureFlows: token-free URL builders and integration-linting tools for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server that equips AI agents with dev workflow tools including GitHub project management, conventional commits, visual regression testing, Jira/Confluence integration, and a persistent memory knowledge graph.14 npmMIT
- AlicenseBqualityDmaintenanceMCP Server for Git operations, agent templates, and project utilities.951 npmMIT
- FlicenseNot gradedqualityBmaintenanceMCP server for AI DevTool workflow, exposing tools and resources for code review, repository chat, and repository operations.1-
- AlicenseAqualityFmaintenanceMCP server for running external coding agents as background tasks inside Claude Code. Supports multiple backends including Codex, Grok, GLM, DeepSeek, and more.7MIT