chienchuanw/gma2-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

18 stars 7 forks 品質 75 トレンド 26Apache-2.0

Repository Install

grandMA2 MCP は、パーシステントの Telnet で grandMA2 onPC をリモートで制御する Python ツールで、自動照明コンソールワークフローとコマンドパイプラインを有効にします.

概要

人工知能アシスタントがTelnetを介してGrandMA2照明コンソールを制御することを可能にするMCPサーバー。キュー管理、フィクスチャ管理、プリセット管理、実行管理、マクロ編集、外観の割り当て、バルク操作、コンソールの状態のクエリ、ファイル管理、読み戻り検証、音楽ショーワークフロー、およびモデルコンテキストプロトコルを介して、101レベルのツールを公開します。 grandMA2 コンソールは、Telnet 上でコマンドを受け入れますが、正しいコマンド文字列を作成するには、MA2 構文ルールの知識が必要です。キーワードの順序、プリセット型マッピング、オプションフラグ、オブジェクト階層。このプロジェクトでは、レイヤーされたコンポーネントの複雑さを処理します。 1. (src/commands/) -- 公式の構文ルールに従って有効な grandMA2 コマンド文字列をビルドする Python 関数。各関数は文字列を返す薄いラッパーです。ネットワークに触れることはありません。 2.(src/server).

概要（AI 翻訳）

コンテンツの表

概要
特徴
始める
前提条件
インストール
構成
MCP登録
使用法
MCPツール
コマンドビルダー
直接テルネットアクセス
コマンド参照
キーワードの助け
オブジェクトキーワード
機能キーワード
キーワード
コピー&移動
アサイン
ラベル
出現
マクロプレースホルダー
プロジェクト構成
開発
トラブルシューティング
ライセンス
貢献

概要

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"
      }
    }
  }
}