# OpenUtau-MCP 🎤🤖

> **Standalone Model Context Protocol (MCP) Server for OpenUtau & DiffSinger**  
> Enables AI Agents (Claude Desktop, Cursor, Antigravity, VS Code) to directly generate, inspect, and micro-tune **OpenUtau v0.6+ (`.ustx`) project files** and **DiffSinger neural expressions**.

---

## 🌟 Features

* 🛠️ **Native `.ustx` Project Generator**: Builds multi-track YAML project files with Singer IDs and Phoneticizer bindings.
* 🎛️ **DiffSinger & Neural Expression Curves**: Generates Dynamics (`dyn`), Tension (`tns`), Breathiness (`bre`), and Vibrato curves.
* 🔍 **Project Inspector**: Parses existing `.ustx` files, extracting track structures, notes, and metadata.
* 🎶 **Acoustic Preview Synthesizer**: Instant 24-bit PCM preview audio synthesis with 25ms cosine-squared crossfading.
* ⚡ **Zero-Dependency Core**: Lightweight Python stdio JSON-RPC 2.0 server.

---

## 🚀 Quick Setup

### 1. Install Dependencies
```bash
pip install -r requirements.txt
```

### 2. Verify Server
```bash
python test_mcp.py
```

### 3. Add to your AI Agent Config (`mcpSettings.json`)
```json
{
  "mcpServers": {
    "openutau-mcp": {
      "command": "python",
      "args": ["F:/antigravity lol/github项目/OpenUtau-MCP/server.py"]
    }
  }
}
```

---

## 📄 License
MIT License (c) 2026 turboegg1145