8 Bits Music MCP

🎵 8位音乐MCP服务器

将你的AI助手变成复古游戏音乐作曲家！这款MCP服务器赋予了Claude、Cursor等其他AI工具创作正宗8位芯片音乐并实现专业音频输出的能力。

🚀 快速入门（2分钟）

步骤1：安装Node.js

确保你有 Node.js 18 或更高版本 已安装：

node --version

如果你没有它，就从（某个地方）下载它

步骤2：配置您的AI助手

选择您偏好的AI工具并按照配置步骤操作：

🤖 表示机器人。 Claude Desktop（可译为“Claude桌面版”或保持原样，若“Desktop”在此处不直接翻译为“桌面版”而是作为产品名称的一部分，则可不译） （最受欢迎）

1. 打开Claude桌面配置文件：

- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - Windows： %APPDATA%\Claude\claude_desktop_config.json - Linux： ~/.config/Claude/claude_desktop_config.json

1. 添加此配置：

{
  "mcpServers": {
    "8bits-music": {
      "command": "npx",
      "args": ["-y", "8-bits-music-mcp"]
    }
  }
}

1. 重启Claude桌面版

1. 在Claude桌面版中寻找🔌图标——你应该会看到“8bits-music”已连接！

💻 电脑 Cursor 集成开发环境（IDE）

1. 首选 设置 → 特点/特性 → MCP 服务器
2. 点击 添加MCP服务器
3. 输入：

- 名字： 8bits-music - 命令： npx - 参数： -y， 8-bits-music-mcp

1. 保存并重启 Cursor

🔧 修理工具或螺丝刀的象征 带有MCP扩展的VS Code

1. 安装 模型上下文协议扩展
2. 打开设置（Ctrl+, 或者 Cmd+,)
3. 搜索“MCP服务器”
4. 添加到 settings.json:

{
  "mcp.servers": {
    "8bits-music": {
      "command": "npx",
      "args": ["-y", "8-bits-music-mcp"]
    }
  }
}

1. 重新加载 VS Code

第三步：开始创作音乐！ 🎮

打开你的AI助手并尝试：

*“使用方波创作一首复古风格的游戏主题曲，旋律朗朗上口，节拍为每分钟140拍”*

*“创作一首带有鼓点的8位风格BOSS战主题曲，并导出为WAV格式”*

*“生成一个以C大调为基础的平静探索主题，使用三角波形”*

就是这样！你的AI现在可以创作8位音乐了！ 🎉

______________________________________________________________________

📋 目录

• 它能做什么？
• 使用示例
• 可用工具
• 乐器与声音
• 音乐理论指南
• 故障排除
• 高级配置
• 对于开发者

✨ 它能做什么？

您的AI助手现在可以：

| 制作原汁原味的复古游戏配乐 | “创作一个超级马里奥风格的主题曲” |

🎵 使用示例

示例1：你的第一首8位音乐作品

Create a simple 8-bit melody with these notes: C4, E4, G4, C5 
using quarter notes and a square wave at 120 BPM

只需询问你的AI助手：

人工智能将使用MCP服务器生成音乐，并为您提供一个曲目ID！

I need a retro platformer game theme:
1. Main melody with square wave
2. Bass line with triangle wave  
3. Techno drums
4. Export everything as "platformer-theme.wav"

示例2：完整的游戏主题

• 人工智能将： create_8bit_melody
• 使用（某种工具或方法）创作旋律 create_8bit_melody 使用另一个添加低音
• 打电话；呼叫 create_8bit_rhythm
• 生成鼓声使用 export_audio_composition

导出混合文件（或导出混合内容）使用

Create an intense boss battle theme:
- Fast tempo (160 BPM)
- Aggressive sawtooth lead
- Heavy drum pattern
- Dark chord progression

示例3：Boss战音乐

Start with a C major scale melody, then:
1. Add a I-V-vi-IV chord progression
2. Layer some drums
3. Show me the track details
4. Export as MIDI so I can edit it

示例4：交互式创作

人工智能处理所有技术细节，您只需描述您的需求！

🎮 可用工具

MCP服务器为您的AI助手提供以下工具：

🎹 创作8比特旋律

用原汁原味的8位音效创作旋律序列。

• AI可以指定：
• 音符（例如，C4，E4，G4）
• 音符时值（四分音符、八分音符、二分音符）
• 波形类型（方波、三角波、锯齿波、脉冲波、噪声波）

节奏（每分钟60-200拍）

🥁 创建8位节奏

生成鼓和打击乐模式。

• basic_rock 可用图案：
• techno - 经典摇滚节奏
• waltz - 电子四拍底鼓（或译为“电子四拍节奏”）
• custom - 3/4拍

- 人工智能设计的图案

🎶 生成和弦进行

根据音乐理论创作和弦进行。

• I-V-vi-IV 常见的进行方式：
• I-IV-V-I - 流行/摇滚（C-G-Am-F和弦）
• ii-V-I - 经典摇滚
• I-vi-IV-V - 爵士标准曲目

- 50年代的进展

💾 导出音频组合

将您的创作导出为音频文件。

• WAV 格式：
• MIDI - 高品质音频

- 可在音乐软件中编辑

🎹 乐器与声音 | 乐器 | 声音 | 最佳用途 | 著名游戏 | |------------|-------|----------|--------------| |（内容未提供）|（内容未提供）|（内容未提供）|（内容未提供）| | □ 方波 | 明亮、富有活力 | 主旋律、主题曲 | 超级马里奥兄弟、洛克人 | | △ 三角波 | 流畅、醇厚 | 低音线条，柔和的主旋律 | 《塞尔达传说》，《密特罗德》 | | ⊿ 锯齿波 | 富丽堂皇，充满攻击性 | 功率和弦，激烈主音 | 《恶魔城》（Castlevania） | ▭ 脉搏波 | 纤薄、原汁原味的NES | 音阶、和声 | 最终幻想 | | ⚡ 噪音

|

随机、打击乐 | 鼓声、爆炸声、音效 | 所有复古游戏 | 声音示例

Perfect for: Main melodies, catchy hooks, Mario-style themes

方波 标志性的“哔”声——明亮清晰

Perfect for: Bass lines, underwater themes, atmospheric sounds

三角波 流畅且低音强劲

Perfect for: Action themes, aggressive leads, rock-style music

锯齿波：

富含谐波，功率强大

🎼 音乐理论指南

• 如果你不是音乐家，不用担心！以下是人工智能所能理解的内容： 常见音阶
• 大调音阶： 快乐，明亮（Do-Re-Mi-Fa-Sol-La-Ti-Do）
• 小调音阶： 悲伤、阴暗、情感丰富
• 五声音阶 简洁，受亚洲风格影响，总是听起来很不错

蓝调音阶：

深情，富有表现力 流行的和弦进行

Examples: "Don't Stop Believin'", "Let It Be"
Use for: Emotional, singalong themes

I-V-vi-IV 翻译成中文是“一-五-六-四”（这里的“一”代表I，“五”代表V，“六”代表vi，“四”代表IV，是音乐理论中的和弦编号）。不过，在实际音乐语境中，我们通常直接使用“I-V-vi-IV”这样的和弦进行表示，而不翻译成具体的数字名称。但若要按照数字名称来翻译，上述就是对应的中文表达 （流行魔法）

Examples: "La Bamba", "Twist and Shout"  
Use for: Upbeat, energetic themes

I-IV-V（在音乐理论中，这通常指的是和弦进行，即从I级和弦到IV级和弦再到V级和弦的进行） （摇滚经典）

Examples: "Grenade", "Apologize"
Use for: Melancholic, emotional scenes

vi-IV-I-V（在音乐理论中，这表示从属和弦-下属和弦-主和弦-属和弦的顺序，但直接翻译为中文不具有实际意义，通常保持原样用于音乐领域）

• （悲伤的进程） 《Tempo Guide》（节奏指南）
• 60-80次/分钟： 缓慢的，营造氛围的（菜单音乐）
• 90-120 次/分钟： 适中（探索主题）
• 130-160 次/分钟： 快速（行动水平）

160-200 每分钟节拍数（BPM）：

非常快（Boss战）

🔧 故障排除

1. “MCP服务器无法连接” npx 8-bits-music-mcp
2. Windows：
3. 打开命令提示符并运行： %APPDATA%\Claude\claude_desktop_config.json
4. 如果你看到“8-Bits Music MCP 服务器正在 stdio 上运行”——说明服务器已启动！ 检查你的配置文件路径： 确保你使用了
5. 双反斜杠

如果使用绝对路径

1. 完全重启Claude桌面版 npx 8-bits-music-mcp
2. macOS/Linux： ~/Library/Application Support/Claude/claude_desktop_config.json 测试服务器：
3. 检查配置： node --version （macOS）

验证 Node.js 版本：

# Clear npm cache
npm cache clean --force

# Try installing globally first
npm install -g 8-bits-music-mcp

# Then use in config
{
  "mcpServers": {
    "8bits-music": {
      "command": "8-bits-music-mcp"
    }
  }
}

（需18岁以上）

“未找到包”错误

npx clear-npx-cache
npx 8-bits-music-mcp

“模块未找到”错误

1. 软件包正在更新。请稍等几分钟再试：
2. 服务器启动了，但AI无法使用它 *检查Claude Desktop中的🔌图标——“8bits-music”是否列在其中？*
3. 试着问：
4. “有哪些可用的MCP服务器？”

完全重启您的AI助手

• 在Claude桌面设置中检查服务器日志 还有问题吗？
• 📖 书籍 查阅完整文档
• 🐛（虫子，通常指昆虫） 报告错误

💬

询问社区（或：向社区求助）

{
  "mcpServers": {
    "8bits-music": {
      "command": "npx",
      "args": ["8-bits-music-mcp@1.0.4"]
    }
  }
}

⚙️ 高级配置

# Install globally
npm install -g 8-bits-music-mcp

# Use in config
{
  "mcpServers": {
    "8bits-music": {
      "command": "8-bits-music-mcp"
    }
  }
}

使用特定版本

{
  "mcpServers": {
    "8bits-music": {
      "command": "npx",
      "args": ["-y", "8-bits-music-mcp"],
      "env": {
        "NODE_ENV": "production",
        "OUTPUT_DIR": "/path/to/music/folder"
      }
    }
  }
}

本地安装（更快）

环境变量

# Clone the repository
git clone https://github.com/ZwitterKaneda/8-bits-music-mcp.git
cd 8-bits-music-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Test locally
node packages/mcp-server/dist/server.js

👨‍💻 为开发者准备

8-bits-music-mcp/
├── packages/
│   ├── mcp-server/          # MCP protocol implementation
│   └── audio-engine/        # 8-bit audio synthesis
├── examples/                # Usage examples
└── docs/                    # Full documentation

想贡献代码还是进行定制？

• 项目结构 技术栈
• MCP 服务器： TypeScript，@modelcontextprotocol/sdk
• 音频引擎： Tone.js用于Web Audio API合成
• 构建： 使用ES模块的TypeScript

运行时长：

Node.js 18及以上版本 API 文档

完整API文档可在以下地址获取：

API 参考文档

1. 🤝 贡献（或“参与贡献”）
2. 我们欢迎投稿！投稿方式如下： git checkout -b feature/amazing-feature
3. 为仓库创建分支（或：克隆仓库）
4. 创建一个特性分支： npm test
5. 做出你的更改 git commit -m 'Add amazing feature'
6. 运行测试： git push origin feature/amazing-feature
7. 提交：

推送：

提交拉取请求

📊 统计数据

• 🗺️ 路线图
• ✅ 版本 1.x（当前版本）
• 基本旋律生成
• 节奏模式

和弦进行

• WAV/MIDI 导出
• 🚧 版本2.0（即将推出）
• 实时音频预览
• 更多仪器类型
• 音频效果（混响、延迟、失真）

模式序列器

• 可视化波形显示
• 💭 版本3.0（未来）
• 多轨调音台
• VST插件支持
• 云渲染

合作创作

基于网页的编辑器\ ❓ 常见问题解答 (FAQ)

问：除了Node.js，我还需要安装其他东西吗？\ A: 不是！只需要 Node.js 18+ 和 npx 命令（npx 是随 Node.js 一起提供的）。

问：我可以将此用于商业用途吗？\ A: 是的！MIT 许可证允许商业使用。

问：它在Linux/Mac/Windows系统上都能运行吗？\ A: 是的，所有支持 Node.js 18+ 的平台都受支持。

问：我可以导出为MP3格式吗？\ A: 目前仅支持WAV和MIDI格式。可以使用外部工具如FFmpeg将WAV转换为MP3。

问：我要如何让AI生成特定风格的作品？\ A: 只需描述你想要的！试试：“创作一个《洛克人》风格的Boss主题”或者“营造一个《塞尔达传说》的地下城氛围”

问：我可以编辑导出的文件吗？\ A: 是的！导出为MIDI文件，以便在任何数字音频工作站（如Ableton、FL Studio、Logic等）中编辑

问：需要互联网吗？

A: 只有首次安装时需要联网，之后就可以离线使用了。 📄 许可证 MIT 许可证 - 请参阅

许可证 文件中有详细信息。

太长，读不下去了

• 你可以随意使用它，无论是商业用途还是个人用途。没有任何限制！ 🙏 致谢
• Anthropic（公司名，可译为“安萨里奇”或根据具体语境保留原名） - 用于创建模型上下文协议
• Tone.js（注：在中文语境下，通常直接保留原名，不进行翻译，但若要解释其含义，可表述为“一个用于音频处理的JavaScript库”） - 惊人的Web音频框架
• 久保田洋之（或译为：小岛秀夫，但需注意，Koji Kondo 实际上更常被译为“久保田洋之”，而“小岛秀夫”是另一知名日本游戏制作人 Kojima Productions 的创始人名字） - 定义了8位音乐的任天堂作曲家

芯片音乐社区

- 为了让复古音乐永存 👨‍💻 作者丹尼尔·迪亚兹（

@ZwitterKaneda（注：这是一个用户名或特定标识，直接翻译无实际意义，保持原样）

• ） 📞 支持 🐛 表示“虫子”或“错误（bug）”的符号。
• 错误报告： GitHub Issues（GitHub问题） 💡 灯泡（或表示“想法”的灯泡图标）
• 功能需求： GitHub 讨论区 ⭐

______________________________________________________________________

为这个项目点赞/收藏这个项目

如果你觉得它有用！

{
  "mcpServers": {
    "8bits-music": {
      "command": "npx",
      "args": ["-y", "8-bits-music-mcp"]
    }
  }
}

______________________________________________________________________

*•*

请求功能