alterios-mcp
This MCP server lets you read, design, controllably write, and validate Alterios/LIMS projects from Codex or other MCP clients.
Inventory and read Alterios objects: projects, content types, fields, views, forms, groups, users, roles, scripts, BPMN, reports, files, comments, view data, process tasks.
Design/scaffold modules: material modules, report tabs, process flows, forms, views, fields, icons, scripts, reports, BPMN diagrams.
Perform controlled writes: preflight, dry-run, plan_id, write gates, apply, API/UI readback, write journal.
Validate: UX contracts, form/module contracts, scripts, Stimulsoft layout, printable PDF, report viewer, process results.
Manage private workboard: Gitea issues/sprints/labels/board sync/agent reports, plus local fallback workboard.
Run bulk operations: update selected content fields, manual scripts, BPMN processes, destructive delete in admin/full.
Administer security/destructive ops: users, groups, roles with dangerous-write gates.
Diagnose runtime/config: profiles, tool profile, runtime fingerprint, stale processes, service catalog, read-only REST/service calls.
Provides tools for managing BPMN processes, tasks, and scripts, integrating with Camunda workflow engine for process automation in Alterios.
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., "@alterios-mcp list all projects from my alterios instance"
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.
alterios-mcp
alterios-mcp - MCP-сервер для чтения, проектирования, управляемой записи и
проверки проектов Alterios/LIMS из Codex и других MCP-клиентов.
Сервер рассчитан на несколько экземпляров Alterios и множество проектов внутри
каждого экземпляра. Основной рабочий контур: инвентаризация -> постановка ->
dry-run -> проверенный plan_id -> запись -> API/UI readback -> приватный отчёт
о результате.
Текущая версия: 0.5.0. Актуальный состав и доступность инструментов: автоматически проверяемый каталог.
Проверяемые ответы 0.5.0: дочитывание результатов через MCP, явная полнота и источник, состояния полей и проверка свежести перед обновлением.
Оптимизация 0.4.0: компактные ответы с полными файлами,
адресный preflight, ограниченная параллельность, кеш снимков и воспроизводимые
замеры. Большие сценарии чтения теперь возвращают компактные ответы по умолчанию;
потребителям полного JSON следует учитывать presentation и режим full.
Новые сценарии чтения: выгрузка с контролем полноты, поиск использования, граф связей, диагностика представлений, журнал, уведомления и скачивание файлов с манифестом SHA-256.
Основные возможности
проекты, типы материалов, поля, контент и файлы;
представления, связи, view entities, поля, фильтры и форматы отображения;
формы, вкладки, строки, ячейки, listeners и действия;
Google Fonts Icons с проектным registry и загрузкой в файловый менеджер;
web/cron/manual/event/library/diagram scripts и их аргументы;
BPMN, процессы, задачи,
camunda:formKeyи проверка side effects;Project Database reports, Stimulsoft templates и printable render/PDF check;
users, user groups, roles и destructive operations через отдельные gates;
сценарные операции для модулей материалов, отчётных вкладок и процессов;
private Gitea work items, agent handoffs и stage labels;
cached project health, write plans, journal, replay smoke и runtime fingerprint.
Полная матрица: docs/alterios-method-coverage.md.
Related MCP server: Kroki MCP
Быстрый старт
1. Установка готового релиза
Требуется Python 3.11 или новее.
$manager = "$env:LOCALAPPDATA\alterios-mcp\manage_release.ps1"
New-Item (Split-Path $manager) -ItemType Directory -Force | Out-Null
Invoke-WebRequest `
"https://github.com/SayAMSTASI/alterios-mcp/releases/latest/download/manage_release.ps1" `
-OutFile $manager
& $manager -Action Install -DotenvPath "C:\path\to\private\alterios.env"Менеджер сам скачивает wheel последнего GitHub Release, проверяет wheel и свою
обновлённую копию по SHA256SUMS.txt, создаёт окружение, устанавливает MCP и
запускает doctor и release smoke. Он сохраняется в постоянном каталоге
пользователя.
Последующие обновления выполняются одной командой:
& "$env:LOCALAPPDATA\alterios-mcp\manage_release.ps1" -Action UpdateПеред обновлением закройте Codex или другой MCP-клиент. Если это неудобно,
добавьте -StopRunningMcp: менеджер остановит только процессы из своей .venv.
Предыдущий release wheel сохраняется и используется для автоматического
rollback, если doctor или release smoke после обновления не пройдут.
Проверить наличие версии и получить варианты исправления можно без записи:
& "$env:LOCALAPPDATA\alterios-mcp\manage_release.ps1" -Action Check
& "$env:LOCALAPPDATA\alterios-mcp\manage_release.ps1" -Action SolutionsДля разработки из исходного кода:
git clone https://github.com/SayAMSTASI/alterios-mcp.git
cd alterios-mcp
python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -e ".[dev]"Для фиксированной версии или автономной установки можно передать менеджеру URL или локальный путь к wheel. После любой операции перезапустите MCP-клиент: работающий процесс не перечитывает пакет и registry автоматически.
.\manage_release.ps1 -Action Update `
-Package "C:\packages\alterios_mcp-0.5.0-py3-none-any.whl" `
-ExpectedSha256 "<sha256>" `
-DotenvPath "C:\path\to\private\alterios.env"1.1. Предложения по устранению проблем
Команда alterios-suggest-fixes запускает read-only диагностику и возвращает
для каждой ошибки несколько вариантов решения: рекомендуемый путь,
альтернативу, готовую команду, уровень риска и необходимость перезапуска.
& "$env:LOCALAPPDATA\alterios-mcp\venv\Scripts\alterios-suggest-fixes.exe" `
--require-config --processes2. Приватная конфигурация
Скопируйте структуру из .env.example в файл вне репозитория. Не коммитьте
токены, cookie, реальные адреса и идентификаторы проектов.
ALTERIOS_PROFILE=primary
ALTERIOS_PROFILES=primary,secondary
ALTERIOS_PRIMARY_BASE_URL=https://alterios-primary.example.local
ALTERIOS_PRIMARY_API_TOKEN=replace-me
ALTERIOS_PRIMARY_AUTH_HEADER=x-api-key
ALTERIOS_PRIMARY_AUTH_SCHEME=
ALTERIOS_PRIMARY_TIMEOUT_SECONDS=20
ALTERIOS_SECONDARY_BASE_URL=https://alterios-secondary.example.local
ALTERIOS_SECONDARY_API_TOKEN=replace-me
ALTERIOS_SECONDARY_AUTH_HEADER=Authorization
ALTERIOS_SECONDARY_AUTH_SCHEME=Bearer
ALTERIOS_SECONDARY_TIMEOUT_SECONDS=20
ALTERIOS_MCP_TOOL_PROFILE=live
ALTERIOS_MCP_ALLOW_WRITE=0
ALTERIOS_MCP_ALLOW_DANGEROUS_WRITE=0
ALTERIOS_MCP_REQUIRED_AGENT_ROLES=analyst,implementer,verifierОдин профиль описывает один экземпляр Alterios. Проект для каждой операции
передаётся явным project_id; default project в профиле используется только
как локальное удобство, а не как скрытая маршрутизация записи.
3. Подключение к Codex
Используйте установленный console entry point. Не создавайте несколько
одинаковых записей mcp_servers.alterios, иначе клиент запустит несколько
экземпляров сервера.
[mcp_servers.alterios]
command = "C:\\Users\\<user>\\AppData\\Local\\alterios-mcp\\venv\\Scripts\\alterios-mcp.exe"
args = []
startup_timeout_sec = 60
tool_timeout_sec = 120
[mcp_servers.alterios.env]
ALTERIOS_DOTENV_PATH = "C:\\path\\to\\private\\alterios.env"
ALTERIOS_MCP_TOOL_PROFILE = "live"Локальная диагностическая команда:
$env:ALTERIOS_DOTENV_PATH = "C:\path\to\private\alterios.env"
& "$env:LOCALAPPDATA\alterios-mcp\venv\Scripts\alterios-mcp.exe"Для MCP config не используйте python -m alterios_mcp.server: console script
является единственной рекомендуемой точкой запуска. Python module entry point
оставлен только для совместимости и диагностики.
4. Проверка после установки
& "$env:LOCALAPPDATA\alterios-mcp\venv\Scripts\alterios-doctor.exe" --require-config --json
& "$env:LOCALAPPDATA\alterios-mcp\venv\Scripts\alterios-profile-smoke.exe" --json
& "$env:LOCALAPPDATA\alterios-mcp\venv\Scripts\alterios-replay-smoke.exe" --jsonПеред записью в конкретный проект:
.\.venv\Scripts\alterios-project-health.exe `
--profile <profile> `
--project-id <project-id> `
--refresh `
--json `
--prettyПрофили MCP tools
Профиль | Tools | Назначение |
| 94 | Основной профиль: health, scenarios, typed writes и проверка результата |
| 68 | Read-only исследование, inventory и validators |
| 119 | Администрирование, security и controlled destructive operations |
| 121 | Разработка MCP и исследование неизвестных routes |
Профиль выбирается до запуска процесса через ALTERIOS_MCP_TOOL_PROFILE.
Для обычных задач используйте live. full не является режимом повышенного
качества и не нужен для повседневной работы.
Подробнее: docs/mcp-tool-profiles.md.
Управляемая запись
Запись по умолчанию выключена. Без выполнения gate-условий tools возвращают план или audit и не отправляют изменяющий запрос.
Обычная запись требует:
Явные
profileиproject_id.Успешный
alterios_live_task_preflight.Dry-run и проверенный
plan_id, если сценарий поддерживает планы.ALTERIOS_MCP_ALLOW_WRITE=1в окружении MCP-процесса.Apply с теми же аргументами и
plan_id.API readback и UI/render check для пользовательской поверхности.
Запись результата в private Gitea, без публикации project evidence в GitHub.
Security/delete дополнительно требуют:
ALTERIOS_MCP_ALLOW_DANGEROUS_WRITE=1и allow_destructive=true в tool call. Перед неизвестным route используйте
alterios_write_safety_preflight.
Подробно: docs/controlled-writes.md.
Сценарные tools
Модуль материала
alterios_create_material_module создаёт согласованный набор:
тип материала и поля;
experimental view, entity и view fields;
list/add/edit/detail forms;
группу меню и project-local icons;
dry-run plan и readback.
Вкладка отчёта
alterios_create_report_tab связывает source view, Project Database report и
form tab, проверяет openId/dataId, template layout и readback. Печатный
результат проверяется alterios_validate_printable_render.
При apply без явного template сценарий берет точный шаблон из сохраненного
dry-run плана; передавать сгенерированный Stimulsoft JSON повторно вручную не нужно.
alterios_diagnose_report_viewer раздельно проверяет source view, тип и шаблон
Stimulsoft, layout, привязку report-ячейки формы, printable PDF и evidence
браузерного viewer-контейнера. Отсутствие browser evidence возвращается как
явное предупреждение, а не маскируется успешным API readback.
Процесс
alterios_create_process_flow связывает task form, scripts, BPMN XML,
camunda:formKey, запуск процесса и task/process readback.
Массовые операции
alterios_bulk_update_selected_content_fields- обновление полей выбранных записей;alterios_fast_live_bulk_manual_script- manual script по выбранным ID;alterios_fast_live_bulk_process- BPMN process по выбранным ID;alterios_fast_live_bulk_delete- destructive delete только вadmin/full.
UX-контракт
Формы и сценарные tools проверяются не только по JSON-схеме, но и по пользовательским правилам:
представления по умолчанию создаются в experimental mode;
для add/edit/list/detail создаются отдельные формы с понятными заголовками;
формы используют фильтр по текущему полю/
openId, когда это требуется связью;технические и неинформативные столбцы скрываются;
footnote используется только для поля даты;
действия элемента оформляются project-local icon + tooltip;
три и более вторичных действий группируются в меню;
табличный заголовок центрирован и выделен bold;
нетабличная ячейка не получает лишний заголовок;
iconIdвсегда относится к файлу текущего проекта.
Проверка одной формы: alterios_validate_form_contract. Единая проверка типа
материала, полей, view/joins, add/edit/view/list форм, иконок, bulk и отчетов:
alterios_validate_module_contract. Источник правил:
docs/ux-contract.md и
docs/ux-contract.json.
Матрица происхождения правил из skills и граница между блокирующими,
evidence-gated и рекомендательными требованиями:
docs/ux-contract-skill-matrix.md.
Архитектура 0.2
server.py больше не содержит бизнес-логику. Он создаёт FastMCP, регистрирует
домены, применяет tool profile и запускает transport.
src/alterios_mcp/
|- server.py composition root
|- tools/ 12 registration-модулей по доменам
|- scenarios/ orchestration, dry-run/apply/readback workflows
|- builders/ чистое построение payload и UI fragments
|- validators/ чистые проверки контрактов
|- client.py HTTP client и route variants
|- tool_profiles.py live/discovery/admin/full registry
|- write_plan.py plan_id и проверка apply
`- runtime_info.py fingerprint процесса и диагностика запускаПравила развития:
Бизнес-операция создаётся в
scenarios/.Payload и validation выносятся в
builders/иvalidators/.tools/<domain>.pyсодержит только регистрацию public callable.Tool name и schema являются совместимым публичным контрактом.
Изменение registry требует обновления golden snapshot.
После изменения обязательны pytest, replay smoke и public-tree scan.
Подробнее: docs/architecture.md.
Агенты и private workboard
Рабочий delivery-контур использует три обязательные роли:
Роль | Ответственность |
| Постановка, Mermaid-схема, модель данных и acceptance criteria |
| Реализация, dry-run/apply и артефакты |
| Независимые tests, readback, UI/render и риски |
PM ведёт private Gitea issue и stage:*, но не блокирует каждую техническую
операцию. Реальные URL, project IDs, названия материалов, HAR и screenshots не
публикуются в открытом репозитории.
Документы:
Проверка разработки
.\.venv\Scripts\python.exe -m pytest
.\.venv\Scripts\alterios-replay-smoke.exe --json
git diff --check
.\.venv\Scripts\python.exe scripts\check_public_tree.pyRegistry защищён golden snapshot: имена tools, схемы аргументов и состав профилей не должны меняться случайно.
Runtime и лишние процессы
Один активный MCP config обычно создаёт один логический сервер. На Windows
console launcher и дочерний python.exe могут отображаться как два связанных
процесса. Большое число независимых экземпляров обычно означает старые Codex
сессии, дублирующиеся MCP configs или не завершённые transports.
Используйте alterios_runtime_info(include_processes=true) для группировки по
instance fingerprint. После обновления:
Завершите старые Codex/MCP сессии.
Убедитесь, что в config одна запись
mcp_servers.alterios.Обновите release wheel или editable package.
Перезапустите Codex.
Проверьте runtime fingerprint и
alterios_replay_smoke.
Подробнее: docs/runtime-hygiene.md.
Документация
Граница публичного репозитория
В GitHub хранятся только переиспользуемый MCP-код, тесты, обезличенные правила, skills, шаблоны и документация. Реальные бизнес-задачи, адреса систем, UUID, названия материалов, пользователи, HAR, screenshots и результаты live-write хранятся в private Gitea или локальном закрытом контуре.
Available Tools
77 toolsalterios_add_commentC
Plan or create an Alterios comment. Execution requires explicit write gates and returns readback.
Inputs: body (required), entity_id (required), entity, dry_run, +3 more. Returns: object
alterios_call_write_serviceC
Plan or call a mutating Alterios script service. Execution requires explicit write gates.
Inputs: args (required), function (required), dry_run, profile, +2 more. Returns: object
alterios_complete_taskC
Plan or complete a BPMN task. Execution advances workflow state.
Inputs: task_id (required), dry_run, profile, contents, +6 more. Returns: object
alterios_configC
Return redacted Alterios configuration and missing required values.
Inputs: profile. Returns: object
alterios_create_material_moduleC
Plan or apply a full Alterios material module: content type, fields, view, forms, and group.
Inputs: fields (required), module_name (required), field_name_prefix (required), names, +25 more. Returns: object
alterios_create_process_flowD
Plan or apply a BPMN process scenario: task form, diagram, script refs, and optional process smoke.
Inputs: diagram_name (required), task_form_name (required), dry_run, plan_id, +26 more. Returns: object
alterios_create_report_tabD
Plan or apply a report plus openId form tab scenario backed by a Project Database source view.
Inputs: report_name (required), source_view_id (required), target_form_id (required), marker, +18 more. Returns: object
alterios_delete_roleC
Plan or delete an Alterios role. Classified as security/destructive write.
Inputs: role_id (required), dry_run, profile, project_id, +2 more. Returns: object
alterios_delete_userC
Plan or delete an Alterios user. Classified as security/destructive write.
Inputs: user_id (required), dry_run, profile, project_id, +2 more. Returns: object
alterios_diagnose_report_viewerC
Diagnose report data, template, form binding, PDF, and browser viewer evidence separately.
Inputs: report_id (required), form_id, profile, tab_name, +9 more. Returns: object
alterios_discover_readonlyC
Probe the known safe read-only Alterios REST routes.
Inputs: profile, project_id. Returns: object
alterios_ensure_project_iconsC
Plan or upload Google Fonts Icons into one Alterios project and return UUID iconId values.
Inputs: dry_run, plan_id, profile, icon_specs, +3 more. Returns: object
alterios_execute_manual_scriptC
Plan or execute a manual Alterios script by UUID with preflight and readback.
Inputs: args (required), script_id (required), dry_run, profile, +4 more. Returns: object
alterios_export_project_iconsC
Export icons from an Alterios elFinder folder to local artifacts with a generated usage guide.
Inputs: profile, recurse, max_files, project_id, +3 more. Returns: object
alterios_fast_live_bulk_deleteC
Plan or destructively delete explicitly reviewed content rows through a dedicated dangerous workflow.
Inputs: profile (required), script_id (required), project_id (required), expected_count (required), +16 more. Returns: object
alterios_fast_live_bulk_manual_scriptC
Plan or execute one reviewed manual script for selected content rows.
Inputs: profile (required), script_id (required), project_id (required), expected_count (required), +18 more. Returns: object
alterios_fast_live_bulk_processC
Plan or start one verified BPMN process for selected content rows.
Inputs: profile (required), diagram_id (required), project_id (required), expected_count (required), +16 more. Returns: object
alterios_fast_live_writeC
Plan or apply one approved scenario through the fast live-write workflow.
Inputs: profile (required), project_id (required), scenario_args (required), scenario_tool (required), +9 more. Returns: object
alterios_file_upload_to_fieldC
Plan or upload a file into an Alterios file field and save it on a content row.
Inputs: filename (required), content_id (required), field_mname (required), text, +9 more. Returns: object
alterios_get_user_groupC
Read one Alterios user group by ID through the typed security route.
Inputs: user_group_id (required), profile, project_id. Returns: object
alterios_list_content_typesC
Read Alterios content types through the typed listandcount route.
Inputs: limit, offset, profile, project_id. Returns: object
alterios_list_fieldsB
Read Alterios content type fields, optionally filtered by content type or field ID.
Inputs: limit, offset, profile, field_id, +2 more. Returns: object
alterios_list_groupsC
Read Alterios project groups.
Inputs: profile, project_id. Returns: object
alterios_list_process_tasksC
Read process instances and active tasks by process, diagram, or content context.
Inputs: profile, content_id, diagram_id, process_id, +1 more. Returns: object
alterios_list_profilesC
Return configured Alterios instance profiles with redacted settings and missing values.
Inputs: profile. Returns: object
alterios_list_project_iconsC
Inventory project-local MCP icon registry and optionally elFinder file-manager icons.
Inputs: profile, recurse, max_files, project_id, +4 more. Returns: object
alterios_list_rolesC
Read Alterios roles through the typed security listandcount route.
Inputs: limit, offset, search, profile, +1 more. Returns: object
alterios_list_user_groupsC
Read Alterios user groups through the typed security listandcount route.
Inputs: limit, offset, search, profile, +1 more. Returns: object
alterios_list_usersC
Read Alterios users through the typed security listandcount route.
Inputs: limit, offset, search, profile, +1 more. Returns: object
alterios_list_write_plansB
List stored dry-run write plans for a profile/project target.
Inputs: profile (required), project_id (required), limit. Returns: object
alterios_patch_form_cell_listenersC
Plan or patch one form cell's emitting.listeners without replacing the whole form manually.
Inputs: form_id (required), listeners (required), row_index (required), tab_index (required), +6 more. Returns: object
alterios_patch_form_tabsC
Plan or replace only tabs on an Alterios form.
Inputs: tabs (required), form_id (required), dry_run, profile, +3 more. Returns: object
alterios_patch_report_templateC
Plan or replace only a report template while preserving report metadata.
Inputs: template (required), report_id (required), dry_run, profile, +4 more. Returns: object
alterios_plan_content_type_publishC
Plan native content-type publish/transfer and review route evidence before execution.
Inputs: content_type_id (required), target_project_ids (required), profile, project_id, +1 more. Returns: object
alterios_profile_smoke_matrixC
Run read-only project-list and default-project route smoke across configured profiles.
Inputs: profile, project_limit, include_project_ids, include_project_names, +1 more. Returns: object
alterios_project_healthB
Return a read-only health summary for forms/views/scripts/BPMN/reports before writes.
Inputs: profile, refresh, use_cache, project_id, +4 more. Returns: object
alterios_replay_smokeB
Run local/read-only MCP replay smoke checks after an update.
Inputs: profile, project_id, include_live, expected_tool_count_min. Returns: object
alterios_report_fullC
Read a full Alterios report by ID through the encoded report filter route.
Inputs: report_id (required), profile, project_id. Returns: object
alterios_resolve_project_iconC
Resolve one semantic icon to a project-local iconId using registry, file-manager scan, or guarded upload.
Inputs: semantic (required), dry_run, plan_id, profile, +7 more. Returns: object
alterios_rest_getC
Run a read-only GET request against an Alterios REST API path.
Inputs: path (required), params, profile, project_id, +1 more. Returns: object
alterios_rest_writeC
Plan or run a mutating REST request. Execution requires explicit write gates.
Inputs: body (required), path (required), method (required), params, +5 more. Returns: object
alterios_service_catalogC
Return known Alterios script-service functions.
Inputs: read_only. Returns: result
alterios_start_processC
Plan or start a BPMN process. Execution creates workflow side effects.
Inputs: diagram_id (required), name, params, dry_run, +6 more. Returns: object
alterios_tool_profileB
Return the active MCP tool profile and filtered registry summary.
Inputs: no named parameters. Returns: object
alterios_update_content_fieldsC
Plan or update fields on an existing Alterios content row. Execution requires explicit write gates.
Inputs: content_id (required), field_values (required), name, dry_run, +5 more. Returns: object
alterios_upsert_bpmn_diagramC
Plan or create/update a BPMN diagram.
Inputs: name (required), value, dry_run, profile, +7 more. Returns: object
alterios_upsert_fieldC
Plan or create/update an Alterios content type field. Execution requires explicit write gates.
Inputs: name (required), field_type (required), content_type_id (required), help, +13 more. Returns: object
alterios_upsert_formC
Plan or create/update an Alterios form. Execution requires explicit write gates.
Inputs: name (required), tabs, dry_run, form_id, +7 more. Returns: object
alterios_upsert_form_manual_script_actionC
Plan or upsert a manual script action on a page, element, or row value with verified id bindings.
Inputs: scope (required), title (required), form_id (required), icon_id (required), +21 more. Returns: object
alterios_upsert_groupC
Plan or create/update an Alterios menu group. Execution requires explicit write gates.
Inputs: name (required), root, order, dry_run, +10 more. Returns: object
alterios_upsert_reportC
Plan or create/update an Alterios report and read it back through report full.
Inputs: name (required), dry_run, profile, template, +5 more. Returns: object
alterios_upsert_user_groupC
Plan or create/update an Alterios user group. Classified as security write.
Inputs: payload (required), dry_run, profile, project_id, +5 more. Returns: object
alterios_upsert_viewC
Plan or create/update an Alterios view. Execution requires explicit write gates.
Inputs: name (required), format, strict, dry_run, +7 more. Returns: object
alterios_upsert_view_entityC
Plan or create/update an Alterios view entity. Execution requires explicit write gates.
Inputs: name (required), view_id (required), joins, config, +6 more. Returns: object
alterios_upsert_view_fieldC
Plan or add/update an Alterios view field. Execution requires explicit write gates.
Inputs: view_id (required), entity_id (required), alias, mname, +9 more. Returns: object
alterios_validate_form_contractC
Validate an Alterios form against the blocking UX contract.
Inputs: form, form_id, profile, project_id. Returns: object
alterios_validate_module_contractA
Validate one complete module without a project-wide scan.
Pass module for a zero-network offline check, or exact object IDs for a
bounded live read. SVG downloads are disabled by default and capped when
explicitly enabled.
Inputs: module, profile, view_id, project_id, +9 more. Returns: object
alterios_validate_printable_renderC
Render a printable Stimulsoft report in Chromium and export PDF evidence.
Inputs: profile, template, report_id, project_id, +2 more. Returns: object
alterios_validate_process_resultC
Read and validate process completion/error state.
Inputs: profile, content_id, diagram_id, process_id, +3 more. Returns: object
alterios_validate_report_project_baseC
Validate a report template and optionally read the source view through get-data-simplified.
Inputs: report_id (required), profile, project_id, view_limit, +3 more. Returns: object
alterios_validate_scriptC
Read and validate an Alterios script by ID or name.
Inputs: name, profile, script_id, project_id, +3 more. Returns: object
alterios_validate_stimulsoft_layoutC
Validate Stimulsoft template geometry for overlaps, page overflow, and dynamic-height risks.
Inputs: profile, template, report_id, project_id, +1 more. Returns: object
alterios_verify_delivery_evidenceC
Verify a private Gitea work item and structured agent handoff comments.
Inputs: work_item_ref (required), agent_handoff_refs (required), dotenv_path, allow_closed, +1 more. Returns: object
alterios_view_data_simplifiedD
Read a view as Stimulsoft usually sees it through get-data-simplified.
Inputs: view_id (required), limit, offset, profile, +1 more. Returns: object
alterios_view_entitiesC
Read configured entities/joins for an Alterios view.
Inputs: view_id (required), profile, project_id. Returns: object
alterios_view_fields_populatedC
Read populated field metadata for an Alterios view.
Inputs: view_id (required), profile, project_id. Returns: object
alterios_write_journalC
Read recent write-plan and write-execution journal entries.
Inputs: profile (required), project_id (required), limit. Returns: object
alterios_write_safety_preflightA
Classify a proposed mutating REST call and return the gates required before execution.
Inputs: path (required), method (required), body, params, +3 more. Returns: object
gitea_create_sprintC
Plan or create a Gitea milestone used as a sprint for the private workboard.
Inputs: state, title, due_on, dry_run, +2 more. Returns: object
gitea_create_work_itemC
Plan or create a private Gitea issue work item for real project work.
Inputs: body (required), title (required), ref, labels, +6 more. Returns: object
gitea_list_sprint_tasksB
List Gitea issue work items for one sprint/milestone.
Inputs: limit, state, labels, milestone, +1 more. Returns: object
gitea_list_work_itemsC
List private Gitea issue work items from the configured workboard repository.
Inputs: limit, query, state, labels, +2 more. Returns: object
gitea_sync_board_by_labelsC
Move Gitea project-board cards into columns based on issue stage:* labels.
Inputs: limit, state, dry_run, apply_mode, +3 more. Returns: object
gitea_workboard_configC
Return redacted private Gitea workboard configuration and missing values.
Inputs: dotenv_path. Returns: object
local_workboard_add_agent_reportC
Plan or append a structured agent report to a local private work item.
Inputs: role (required), scope (required), item_id (required), findings (required), +8 more. Returns: object
local_workboard_configA
Return the local private workboard target used when Gitea is unavailable.
Inputs: base_dir, dotenv_path. Returns: object
local_workboard_initC
Create the local private workboard folder structure.
Inputs: base_dir, dotenv_path. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 77 tools
Many tools are clearly tied to distinct resources, but there are multiple near-overlapping clusters: seven validate_* tools, several fast_live_bulk_* write paths versus execute/call/rest write tools, and overloaded terms like group (project/user/menu) and field (content type/view/content row). The descriptions help, but an agent would frequently need to read closely to avoid misselection.
All tool names use snake_case with a consistent alterios_/gitea_/local_ prefix and mostly follow a verb_noun pattern. Minor deviations include mixed write verbs (upsert/update/patch/execute/call/start) and awkward modifiers like fast_live_bulk_, but the overall convention is predictable and readable.
With 77 tools, this server is far beyond the 50+ threshold for an extreme count. Even though the server spans CMS, BPMN, reports, security, icons, and workboards, the sheer number creates a heavy and exhausting tool-selection surface rather than a well-scoped one.
The surface is broad and covers many lifecycles: content types, fields, views, forms, reports, BPMN, security, icons, and workboard operations. However, there are notable gaps: security has delete role/user but no create/update equivalents, content rows lack a generic create tool, and many resource types have no delete or full lifecycle coverage.
Maintenance
Related MCP Connectors
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
An MCP server that provides read access to your cloud storage providers, bank accounts and more.
A MCP server built for developers enabling Git based project management with project and personal…
MCP server for Product Management
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA production-oriented MCP server for coding agents that enables multi-project management through secure file operations, Git integration, and safe command execution. It supports project discovery across multiple root directories and provides robust audit logging with both STDIO and HTTP transport options.2MIT
- AlicenseNot gradedqualityDmaintenanceA production-ready MCP server scaffold that features built-in authentication, Docker support, and a comprehensive CI/CD release pipeline. It provides a standardized template for deploying servers with multi-transport support and configurable read-only modes.MIT
- AlicenseNot gradedqualityDmaintenanceProduction-ready MCP server for Atlassian Jira and Confluence, providing tools for issue management, page retrieval, and content operations.87 npm1MIT
- FlicenseNot gradedqualityCmaintenanceAn MCP server with HTTP/stdio support, a web admin panel for managing services, capabilities, and user permissions with Bearer token authentication, enabling relay and access control for MCP tools.-