Сервер MCP, который позволяет помощникам ИИ управлять консолями освещения GrandMA2 через Telnet. Он предоставляет 101 высокоуровневый инструмент для управления сигналами, управления креплением, управления предустановленными настройками, управления исполнителем, макроредактирования, назначения внешнего вида, массовых операций, запросов состояния консоли, управления файлами отображения, проверки считывания, рабочих процессов музыкального шоу и многое другое через протокол Model Context.

Таблица содержимого

• Обзор
• Особенности
• Начинаем.
• Предварительные условия
• Установка
• Конфигурация Регистрация MCP
• Использование Инструменты MCP Командующий Строитель Прямой доступ к Telnet
• Командная ссылка Помогают ключевые слова
• Объектные ключевые слова Функциональные ключевые слова В ключевом слове
• Копировать и двигаться
• Назначение
• Метка
• Внешность Macro Placeholder Структура проекта
• Развитие
• Устранение неполадок
• Лицензия
• Вклад

Обзор

Консоли GrandMA2 принимают команды через Telnet, но для построения правильных командных строк требуется знание правил синтаксиса MA2 - порядок ключевых слов, предварительно заданные отображения типов, флаги опций и иерархии объектов. Этот проект обрабатывает эту сложность в слоистых компонентах:

GMA2 MCP

An MCP server that lets AI assistants control grandMA2 lighting consoles via Telnet. It exposes 101 high-level tools for cue management, fixture control, preset management, executor control, macro editing, appearance assignment, bulk operations, console state queries, show file management, read-back verification, music show workflows, and more through the Model Context Protocol.

Table of Contents

• Overview
• Features
• Getting Started
  • Prerequisites
  • Installation
  • Configuration
  • MCP Registration
• Usage
  • MCP Tools
  • Command Builder
  • Direct Telnet Access
• Command Reference
  • Helping Keywords
  • Object Keywords
  • Function Keywords
  • At Keyword
  • Copy and Move
  • Assign
  • Label
  • Appearance
  • Macro Placeholder
• Project Structure
• Development
• Troubleshooting
• License
• Contributing

Overview

grandMA2 consoles accept commands over Telnet, but building correct command strings requires knowledge of the MA2 syntax rules – keyword ordering, preset type mappings, option flags, and object hierarchies. This project handles that complexity in layered components:

1. Command Builder (src/commands/) – Python functions that construct valid grandMA2 command strings following the official syntax rules. Each function is a thin wrapper that returns a string; it never touches the network.
2. MCP Server (src/server.py) – A FastMCP server that exposes 101 tools covering cue management, fixture control, presets, executors, global state, labeling, appearance assignment, macro editing, bulk cue operations, sequence playback, console state queries, show file management, read-back verification, music show workflows, and raw commands over stdio transport. It manages a persistent Telnet connection to the console and delegates command construction to the builder layer.
3. Response Parser (src/response_parser.py) – Pure functions for parsing grandMA2 Telnet output: tabular List data into structured dicts, and inline Error #NN: REASON failures (with ANSI stripping) for the verified execution path.
4. Execution Core (src/execution.py) – ExecutionResult plus the pure build_result() that turns a raw Telnet reply into a structured {ok, echo, error_code, error_text, raw}. Mutating tools route through GMA2TelnetClient.execute() so they report the console’s real outcome instead of fabricating success.