MMCPMarkets
CG

chienchuanw/gma2-mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。 查看原文

18 stars 7 forks 质量 75 趋势 26Apache-2.0
Repository Install

grandMA2 MCP是一种Python工具,通过持久Telnet来远程控制GrandMA2在PC上,可以实现自动照明-收发管工作流程和指令管.

概览

一个MCP服务器,让AI助手通过Telnet控制GrandMA2照明控制台. 它暴露出101个高级工具,用于提示管理,固定控制,预设管理,执行器控制,宏编辑,外观分配,批量操作,控制台状态查询,显示文件管理,回读验证,音乐显示工作流程,更多通过"模式上下文协议". grandMA2控制台接受超过Telnet的命令,但构建正确的命令字符串需要了解MA2语法规则——关键词命令,预设类型映射,选项旗帜,以及对象分级. 该项目处理分层组件的复杂性: 1. (弧/命令/) -- Python 函数按照正式语法规则构造有效的 grandMA2 命令字符串 。 每个函数都是一薄的包装器,可以返回一个字符串;它从不触及网络. 2. (弧/服务器.

概述（AI 翻译）

一个MCP服务器,让AI助手通过Telnet控制GrandMA2照明控制台. 它暴露出101个高级工具,用于提示管理,固定控制,预设管理,执行器控制,宏编辑,外观分配,批量操作,控制台状态查询,显示文件管理,回读验证,音乐显示工作流程,更多通过"模式上下文协议".

□ 目录

  • 概览
  • 特征
  • 开始
  • 先决条件
  • 安装
  • 配置
  • MCP登记
  • 使用费
  • MCP工具
  • 命令构建器
  • 直接电话网接入
  • 命令参考
  • 帮助关键词
  • 对象关键词
  • 函数关键词
  • 在关键词
  • 复制并移动
  • 指派
  • 标签
  • 外观
  • 宏观占位符 项目结构
  • 发展
  • 解决问题
  • 执照
  • 贡献

□ 概览

grandMA2控制台接受超过Telnet的命令,但构建正确的命令字符串需要了解MA2语法规则——关键词命令,预设类型映射,选项旗帜,以及对象分级. 该项目处理分层组件的复杂性:

  1. 联合国.

本页由 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.

Table of Contents

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.
在 GitHub 查看完整 README

安装

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

Open the repository installation guide 新手？先看 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" } } } }