chienchuanw/gma2-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

19 stars 6 forks 품질 75 트렌드 14Apache-2.0

Repository Install

grandMA2 MCP는 지속 가능한 Telnet을 통해 grandMA2 onPC를 원격으로 제어하는 Python 도구이며 자동화된 조명 컨솔 워크플로우 및 명령 파이프라인을 가능하게 합니다.

개요

MCP 서버는 Telnet을 통해 grandMA2 조명 콘솔을 제어 할 수 있습니다. 큐 관리, 고정 제어, 사전 설정 관리, 실행 제어, 매크로 편집, 외관 할당, 대량 작업, 콘솔 상태 쿼리, 쇼 파일 관리, 읽기-백 검증, 음악 쇼 워크플로우 및 모델 Context 프로토콜을 통해 더 높은 수준의 도구를 제공합니다. grandMA2 콘솔은 Telnet을 통해 명령을 수락하지만 올바른 명령 문자열은 MA2 구문 규칙의 지식을 필요로한다 -- 키워드 주문, 미리 설정 유형 매핑, 옵션 플래그 및 객체 계층. 이 프로젝트는 계층화 된 구성 요소의 복잡성을 다룹니다. 1. (src/commands/) -- 공식 구문 규칙을 따르는 grandMA2 명령 문자열을 구성하는 Python 함수. 각 함수는 문자열을 반환하는 얇은 래퍼입니다; 그것은 네트워크에 결코 접촉하지 않습니다. 2. (src/서버.

개요(AI 번역)

MCP 서버는 Telnet을 통해 grandMA2 조명 콘솔을 제어 할 수 있습니다. 큐 관리, 고정 제어, 사전 설정 관리, 실행 제어, 매크로 편집, 외관 할당, 대량 작업, 콘솔 상태 쿼리, 쇼 파일 관리, 읽기-백 검증, 음악 쇼 워크플로우 및 모델 Context 프로토콜을 통해 더 높은 수준의 도구를 제공합니다.

내용 표

개요
특징
시작하기
필수
설치
구성
MCP 등록
사용
MCP 도구
명령 빌더
직접 Telnet 액세스
명령 참조
도움말 키워드
키워드
기능 키워드
키워드
복사 및 이동
할당
상표
외관
Macro Placeholder(주)
프로젝트 구조
개발
문제 해결
라이센스
기여

개요

grandMA2 콘솔은 Telnet을 통해 명령을 수락하지만 올바른 명령 문자열은 MA2 구문 규칙의 지식을 필요로한다 – 키워드 주문, 미리 설정 유형 매핑, 옵션 플래그 및 객체 계층. 이 프로젝트는 계층화 된 구성 요소의 복잡성을 다룹니다.

명세.

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

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.

Overview
Features
Getting Started
Usage
Command Reference
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:

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

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "gma2": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/gma2-mcp",
        "run",
        "python",
        "-m",
        "src.server"
      ],
      "env": {
        "GMA_HOST": "2.0.0.1",
        "GMA_USER": "administrator",
        "GMA_PASSWORD": "admin"
      }
    }
  }
}