16bits Gaudio MCP

16位高斯mcp

一个Zig供电的MCP服务器，可以生成游戏音频——可循环的背景音乐、音效和叮当声——作为16位PCM WAV文件。

克劳德称之为工具 .wav 文件出来了。就这样

• 零外部依赖（仅限Zig标准库）
• 16位PCM WAV输出
• FM合成、施罗德混响、ADSR包络、多轨混音
• 通过种子进行确定性生成——每次都是相同的种子=相同的输出

样品

以下所有样本均由该工具生成。点击在GitHub上收听，或克隆仓库以获取WAV文件。

背景音乐

音效

叮当声

快速开始

brew tap matuyuhi/tools
brew install 16bits-audio-mcp

添加到您的Claude配置(~/.claude/settings.json 克劳德代码，或 claude_desktop_config.json 桌面）：

{
  "mcpServers": {
    "16bits-audio": {
      "command": "16bits-audio-mcp"
    }
  }
}

然后问克劳德：

Generate a dungeon BGM at 90 BPM in A harmonic_minor, 8 bars, and play it

您可以生成什么

BGM——15种款式

完整的4轨乐曲（旋律、低音、和声、打击乐），具有每种风格的音色、节奏和混响。

每种风格都使用不同的波形、ADSR包络、打击模式（踢腿/响弦/高帽/边缘/振动器）、摇摆和混响设置。

音效——20种

所有SE支持 pitch （0.5–2.0）以及 volume （0.0–1.0）用于调整。

铃儿——12种

节奏感选项： fast, normal, slow, triumphant

磅秤——10种类型

音效——9种类型（通过 wav_fx)

效果可以被链接——它们是按顺序应用的。

示例提示

基础世代

Generate a boss battle BGM at 160 BPM in D minor, 8 bars

Create jump and coin sound effects, then play them

Make a victory jingle in G major with triumphant tempo

创意组合

Generate a cyber BGM at 140 BPM in A harmonic_minor, then apply bitcrusher (8-bit, downsample 4) for retro feel

Create a forest BGM in E lydian at 100 BPM, 16 bars, then add chorus and reverb

Generate explosion, laser, and hit SEs with different pitches, then mix them with offsets into one file

工作流程：使用种子进行迭代

Generate a dungeon BGM with seed 42 — if you like the melody, keep the same seed and try different scales

这 seed 参数使BGM生成具有确定性。相同的种子+相同的参数=相同的输出。改变 key, scale，或 bpm 同时保留种子以保持旋律形状。

安装

自制（推荐）

brew tap Matuyuhi/tools
brew install 16bits-audio-mcp

一个衬垫

curl -fsSL https://raw.githubusercontent.com/Matuyuhi/16bits-gaudio-mcp/main/install.sh | bash

从源代码构建

需要 之字形 0.15.x。

git clone https://github.com/Matuyuhi/16bits-gaudio-mcp.git
cd 16bits-gaudio-mcp
zig build
# binary: zig-out/bin/16bits-audio-mcp

或者：

make install   # builds and installs to ~/.local/bin

配置

克劳德代码

添加 ~/.claude/settings.json:

{
  "mcpServers": {
    "16bits-audio": {
      "command": "16bits-audio-mcp"
    }
  }
}

克劳德桌面

添加 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：

{
  "mcpServers": {
    "16bits-audio": {
      "command": "16bits-audio-mcp"
    }
  }
}

如果从源代码构建，请使用完整路径：

{
  "mcpServers": {
    "16bits-audio": {
      "command": "/path/to/zig-out/bin/16bits-audio-mcp"
    }
  }
}

工具参考（9个工具）

bgm_compose

生成4首曲目（旋律、低音、和声、打击乐）的可循环背景音乐。

叮当声

生成简短的游戏事件广告歌曲。

se_gen

生成游戏音效。

note_synth

将单音或和弦合成到WAV。

fm_patch

使用FM合成（YM2612型2-运算符）生成音调。

wav_fx

将效果链应用于现有的WAV文件。

wav_mix

将多个WAV文件混合成一个。

wav_info

获取WAV文件元数据和波形统计数据（采样率、信道、比特深度、持续时间、RMS/峰值dB）。

wavplay

异步播放WAV文件（macOS： afplay，Linux： aplay).

支持的密钥

C、 C#、D、D#、E、F、F#、G、G#、A、A#、B（以及平面：Db、Eb、Gb、Ab、Bb）

音符范围：C0–B9（MIDI 12–131）。A4=440Hz。

提示

• 迭代种子：使用 seed 锁定你喜欢的旋律，然后调整 key, scale, bpm，或 style.
• 效果链：按顺序应用多种效果，例如。， bitcrusher → reverb 适用于低保真环境。
• 混合工作流程：生成单独的曲目（BGM、SE、广告歌曲），然后与 wav_mix 使用 offset_ms 为了精确计时。
• 变桨SE：使用 pitch: 0.5 对于较重的声音， pitch: 2.0 更轻/更快的变体。
• 低保真复古音效：申请 bitcrusher （bit_depth:4-8，下采样：2-8）转换为任何生成的音频。

贡献

欢迎在 Matuyuhi/16位高斯微控制器.

zig build          # build
zig fmt src/       # format

许可证

麻省理工学院