Soundraw Game Bgm

Soundraw游戏BGM MCP服务器

MCP（模型上下文协议）服务器，使AI代理能够生成游戏背景音乐。用途 深度求索 用于智能场景分析和参数生成，以及 Soundraw B2B API V3 用于实际的音乐生成。

🎶 为什么游戏开发者❤️ 这

现代游戏使用动态、自适应的音乐，但编写自定义背景音乐既昂贵又耗时。\ soundraw游戏bgm自动作曲 通过分析您的游戏场景并生成免版税的背景音乐 *适合情绪和游戏环境*.

它甚至输出即用型集成代码 统一 和 虚幻引擎 这样你就可以在没有额外工程工作的情况下投入使用。

建筑

Game Dev Agent (Claude/Cursor)
    ↓ calls MCP tool
MCP Server (soundraw-game-bgm)
    ↓ uses DeepSeek API for reasoning
DeepSeek analyzes game context
    ↓ generates Soundraw parameters (moods, genres, themes, tempo, energy)
Soundraw API generates actual music
    ↓ async: returns request_id → poll for result
Game Dev Agent receives share_link + audio_url

特性

• 成本优化：使用DeepSeek（比Claude便宜约90%）进行场景分析
• 4个MCP工具：满足游戏音频需求的全套设备
• 真正的Soundraw API：使用具有正确异步处理的B2B API V3
• 发动机集成：虚幻、Unity和Godot的自动生成代码片段
• 自适应音频：动态游戏音频层的茎静音

安装

git clone https://github.com/yksanjo/soundraw-game-bgm.git
cd soundraw-game-bgm
npm install
npm run build

配置

创建一个 .env 文件：

DEEPSEEK_API_KEY=sk-your-deepseek-api-key
SOUNDRAW_API_KEY=your-soundraw-bearer-token

测试API连接

在使用MCP服务器之前，请验证您的API密钥是否有效：

# Quick test (checks API connections only)
npm run test:apis

# Full test (generates a 10-second track - uses API credits)
npm run test:apis:full

预期产量：

🎮 Soundraw Game BGM MCP Server - API Test

==================================================
Testing DeepSeek API
==================================================
API Key: sk-xxxxxx...
✅ DeepSeek Response: "DeepSeek OK"

==================================================
Testing Soundraw API Connection
==================================================
API Key: xxxxxxxxxx...
✅ Soundraw Account: Number of queries: X from ...

==================================================
Testing Soundraw Tags Endpoint
==================================================
✅ Available genres for "Epic" mood: Orchestra, Electronica...
✅ Available themes: Gaming, Cinematic...

==================================================
Test Summary
==================================================
✅ DeepSeek API
✅ Soundraw Connection
✅ Soundraw Tags
❌ Music Generation (skipped without --full flag)

🎉 Core APIs working! Ready to use the MCP server.

MCP工具

1. generate_bgm

根据游戏场景描述生成背景音乐。

输入：

{
  "scene": "boss_fight",
  "game_genre": "dark_souls_like",
  "intensity": "high",
  "mood": "epic",
  "duration_seconds": 60,
  "engine": "unreal",
  "file_format": "m4a"
}

输出：

{
  "share_link": "https://soundraw.io/edit_music?m=...",
  "audio_url": "https://..../final_xxx.m4a",
  "request_id": "...",
  "duration_seconds": 60,
  "bpm": 140,
  "timestamps": [{"start": 0, "end": 15, "energy": "Low"}, ...],
  "file_format": "m4a",
  "integration_code": "// Unreal Engine 5 integration...",
  "deepseek_reasoning": "Boss fights need epic orchestral...",
  "soundraw_params": {"moods": ["Epic", "Dark"], "genres": ["Orchestra"], ...}
}

2. get_bgm_variations

生成现有BGM的变体。

输入：

{
  "share_link": "https://soundraw.io/edit_music?m=...",
  "variation_type": "similar",
  "length": 60
}

或定制能量/茎：

{
  "share_link": "https://soundraw.io/edit_music?m=...",
  "variation_type": "customize",
  "energy_preset": "building",
  "mute_stems": ["me"]
}

阀杆代码： bc （背衬）， bs （低音）， dr （鼓）， me （旋律）， fe （填充结束）， ff （填充开始）

3. adaptive_layer_control

生成多个版本，其中不同的音柄被静音以实现自适应音频。

输入：

{
  "share_link": "https://soundraw.io/edit_music?m=...",
  "layers_to_keep": ["drums", "bass", "melody", "backing"]
}

输出： 每层单独的音频URL+用于运行时混合的JavaScript集成代码。

4. scene_transition_music

在场景之间生成过渡音乐。

输入：

{
  "from_scene": "peaceful village exploration",
  "to_scene": "intense boss battle",
  "transition_type": "stinger",
  "duration_seconds": 15
}

过渡类型：

• fade：逐渐的能源转移
• stinger：戏剧性的口音
• crossfade：平滑混合

使用Claude代码

增添 ~/.mcp.json:

{
  "mcpServers": {
    "soundraw-game-bgm": {
      "command": "node",
      "args": ["/path/to/soundraw-game-bgm/dist/index.js"],
      "env": {
        "DEEPSEEK_API_KEY": "sk-your-key",
        "SOUNDRAW_API_KEY": "your-bearer-token"
      }
    }
  }
}

然后重新启动Claude Code并尝试：

Generate epic boss battle music for my Dark Souls-like game, 60 seconds, with Unreal Engine integration code

Soundraw API参数

服务器将游戏场景映射到这些Soundraw参数：

情绪： 愤怒、忙碌与疯狂、黑暗、梦幻、优雅、史诗、欢乐、恐惧、滑稽与怪异、迷人、快乐、沉重与沉思、希望、悠闲、神秘、和平、不安、浪漫、奔跑、悲伤、恐惧、感伤、性感、流畅、悬疑

体裁： 原声音乐、嘻哈音乐、Beats、Funk、流行音乐、Drum n Bass、Trap、东京夜间流行音乐、摇滚、拉丁音乐、House、热带之家、环境音乐、管弦乐队、电子与舞蹈、电子乐、Techno&Trance、泽西俱乐部、Drill、R&B、Lofi嘻哈、世界、Afrobeats、圣诞节

主题： 广告与预告片、广播、电影、企业、喜剧、烹饪、纪录片、戏剧、时尚与美容、游戏、假日季、恐怖与惊悚片、励志与激励、自然、摄影、体育与动作、科技、旅游、教程、视频日志、婚礼与浪漫、锻炼与健康

速度： 低（\125 bpm）

能量水平： 静音、低、中、高、甚高

发展

# Run in development mode (watches for changes)
npm run dev

# Type check
npm run typecheck

# Build
npm run build

# Run built version
npm start

# Test API connections
npm run test:apis

成本

DeepSeek处理推理的成本比Claude API低约90%。

许可证

麻省理工学院