nt_helper 项目使用说明

'nt_helper' 是一个用于管理 Expert Sleepers Disting NT 模块预设的跨平台桌面及移动应用。它提供了一个直观的图形界面，同时也包含一个内置的 MCP (Model Context Protocol) 服务器，允许外部工具（如AI助手）通过编程方式与应用交互和控制 Disting NT 模块。

主要功能点

预设管理: 创建、加载和保存 Disting NT 模块上的预设。
算法编辑: 编辑每个算法的详细参数，部分算法有专属编辑界面。
参数映射: 配置 CV、MIDI 和 I2C 输入到算法参数的映射。
可视化布线: 查看算法之间的信号流连接。
性能模式: 在一个屏幕上查看和控制所有已映射的参数。
内置 MCP 服务器: 在桌面平台提供一个 MCP 接口，使 AI 或其他兼容 MCP 的客户端能够调用应用功能，例如获取当前预设状态、添加/移除算法、设置参数值等。
离线数据管理: 即使不连接硬件，也能管理算法元数据。
跨平台: 支持 Windows, macOS, Linux, iOS 和 Android (MCP 服务器功能仅限桌面平台)。

安装步骤

访问项目的 GitHub Releases 页面 (https://github.com/thorinside/nt_helper/releases)，下载适用于您操作系统的最新版本安装包。iOS 用户可以通过 TestFlight (https://testflight.apple.com/join/BSFFSpd3) 获取。
按照操作系统的标准流程安装下载的应用。
通过 USB 连接您的 Disting NT 模块到电脑。
启动 'nt_helper' 应用，在应用内选择正确的 MIDI 输入/输出端口，然后点击连接。

服务器配置 (供 MCP 客户端参考)

'nt_helper' 的 MCP 服务器是内置于主应用程序中的。这意味着 MCP 客户端不需要连接到一个独立的服务器进程，而是需要启动 'nt_helper' 应用程序本身。MCP 客户端（如兼容 MCP 的 AI 助手）通常需要以下信息来配置与 'nt_helper' 的集成：

服务器名称: 可以是任何描述性的名称，例如 "Disting NT Helper MCP"。
启动命令 (command): 这是 'nt_helper' 应用程序的可执行文件路径。例如，在 Windows 上可能是 'C:\Program Files\nt_helper\nt_helper.exe'，在 macOS 上可能是 '/Applications/nt_helper.app/Contents/MacOS/nt_helper'。用户需要根据实际安装位置填写此路径。
启动参数 (args): 根据目前的仓库信息，启动 'nt_helper' 应用作为 MCP 服务器时可能不需要额外的命令行参数。MCP 客户端配置中的 'args' 字段可以为空数组 '[]'。

示例 MCP 客户端配置 (JSON 格式概念说明，用户应在客户端界面配置):

// 这是一个示例，说明MCP客户端可能需要的配置信息
// 用户不应直接编辑此代码块，而是在其MCP客户端应用中填写相关信息
{
  "server name": "Disting NT Helper MCP",
  "command": "/path/to/your/nt_helper/executable", // <-- 用户需要修改为实际路径
  "args": [],
  "description": "MCP server for controlling Expert Sleepers Disting NT via nt_helper app"
}

重要提示:

MCP 服务器功能目前仅在 'nt_helper' 的桌面版本上可用。
客户端需要启动 'nt_helper' 应用程序，并与其建立通信。具体的通信协议（如 Stdio, WebSocket）由 MCP 客户端和 'nt_helper' 的内置服务器实现决定，用户通常无需手动配置这些细节。

基本使用方法

确保您已按照“安装步骤”成功连接并启动应用。
使用应用界面来加载、编辑和管理 Disting NT 模块的预设、算法和参数。
对于希望通过 MCP 客户端（如AI助手）控制 'nt_helper' 的用户：
- 在您的 MCP 客户端中，按照上述“服务器配置”说明，添加或配置与 'nt_helper' 的连接。
- 客户端应能发现 'nt_helper' 暴露的工具列表（例如 'get_current_preset', 'set_parameter_value' 等）。
- 您可以通过 MCP 客户端向 'nt_helper' 发送请求，调用这些工具来获取模块状态或改变参数。

例如，通过 MCP 客户端调用 'get_current_preset' 工具，您可以获取当前 Disting NT 模块上所有槽位的算法和参数概况。调用 'set_parameter_value' 工具并指定槽位、参数索引和值，可以远程修改模块参数。详细的工具列表和用法请参考 'nt_helper' 仓库中的 MCP 工具参考文档。

关键词

nt_helper 项目使用说明

主要功能点

安装步骤

服务器配置 (供 MCP 客户端参考)

基本使用方法

信息