Skip to main content
Glama
alterios-mcp

alterios-mcp

by SayAMSTASI

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 --processes

2. Приватная конфигурация

Скопируйте структуру из .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

Назначение

live

94

Основной профиль: health, scenarios, typed writes и проверка результата

discovery

68

Read-only исследование, inventory и validators

admin

119

Администрирование, security и controlled destructive operations

full

121

Разработка MCP и исследование неизвестных routes

Профиль выбирается до запуска процесса через ALTERIOS_MCP_TOOL_PROFILE. Для обычных задач используйте live. full не является режимом повышенного качества и не нужен для повседневной работы.

Подробнее: docs/mcp-tool-profiles.md.

Управляемая запись

Запись по умолчанию выключена. Без выполнения gate-условий tools возвращают план или audit и не отправляют изменяющий запрос.

Обычная запись требует:

  1. Явные profile и project_id.

  2. Успешный alterios_live_task_preflight.

  3. Dry-run и проверенный plan_id, если сценарий поддерживает планы.

  4. ALTERIOS_MCP_ALLOW_WRITE=1 в окружении MCP-процесса.

  5. Apply с теми же аргументами и plan_id.

  6. API readback и UI/render check для пользовательской поверхности.

  7. Запись результата в 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 процесса и диагностика запуска

Правила развития:

  1. Бизнес-операция создаётся в scenarios/.

  2. Payload и validation выносятся в builders/ и validators/.

  3. tools/<domain>.py содержит только регистрацию public callable.

  4. Tool name и schema являются совместимым публичным контрактом.

  5. Изменение registry требует обновления golden snapshot.

  6. После изменения обязательны pytest, replay smoke и public-tree scan.

Подробнее: docs/architecture.md.

Агенты и private workboard

Рабочий delivery-контур использует три обязательные роли:

Роль

Ответственность

analyst

Постановка, Mermaid-схема, модель данных и acceptance criteria

implementer

Реализация, dry-run/apply и артефакты

verifier

Независимые 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.py

Registry защищён golden snapshot: имена tools, схемы аргументов и состав профилей не должны меняться случайно.

Runtime и лишние процессы

Один активный MCP config обычно создаёт один логический сервер. На Windows console launcher и дочерний python.exe могут отображаться как два связанных процесса. Большое число независимых экземпляров обычно означает старые Codex сессии, дублирующиеся MCP configs или не завершённые transports.

Используйте alterios_runtime_info(include_processes=true) для группировки по instance fingerprint. После обновления:

  1. Завершите старые Codex/MCP сессии.

  2. Убедитесь, что в config одна запись mcp_servers.alterios.

  3. Обновите release wheel или editable package.

  4. Перезапустите Codex.

  5. Проверьте runtime fingerprint и alterios_replay_smoke.

Подробнее: docs/runtime-hygiene.md.

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

Граница публичного репозитория

В GitHub хранятся только переиспользуемый MCP-код, тесты, обезличенные правила, skills, шаблоны и документация. Реальные бизнес-задачи, адреса систем, UUID, названия материалов, пользователи, HAR, screenshots и результаты live-write хранятся в private Gitea или локальном закрытом контуре.

Available Tools

77 tools
alterios_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

    C2.3/5.0

    Scored across 77 tools

    Disambiguation3/5

    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.

    Naming Consistency4/5

    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.

    Tool Count1/5

    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.

    Completeness3/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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.
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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
    • F
      license
      Not graded
      quality
      C
      maintenance
      An 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.
      -