MCP server that exposes VOCALOID 6 project (.vpr) creation, parsing, editing, and export capabilities through natural language via MCP-compatible AI assistants
Server has 13 tools with mostly complete schemas and descriptions in Chinese. Naming follows verb_noun pattern (list_voices, create_project, add_notes, etc.). Descriptions are present but vary in quality, some are detailed (add_notes: 200+ chars with examples), others minimal (list_voices: 150 chars). All tools have input schemas with types and descriptions. However, output schemas are not formally documented, responses are inferred from code. Error handling is basic (ValueError with messages). No tool annotations (readOnlyHint, destructiveHint) despite clear risk levels. Parameter descriptions are adequate but lack explicit constraints (e.g., tempo range, tick bounds). Chinese descriptions may reduce LLM clarity vs. English.
批量往某轨某片段添加音符,并自动同步片段时长。 notes 每项是一个 dict: pos: 起始 tick(1 拍 = 480;1 小节(4/4) = 1920)必填 duration: 时长 tick,必填 number: 音高,可填 MIDI 数字(60=C4) 或音名("C4"/"F#5"/"Bb3"),必填 lyric: 歌词(如日文假名/罗马音/英文),必填 phoneme: 音素,可选,缺省等于 lyric velocity: 力度 0-127,可选,默认 64 例:[{"pos":0,"duration":480,"number":"C4","lyric":"a"}, {"pos":480,"duration":480,"number":"E4","lyric":"i"}]
给工程加一条歌手轨(含一个空片段),返回 {track, part} 索引。 参数: singer: 歌手名(见 list_voices)或自定义名(需配合 comp_id)。 language: 演唱语言 JP / EN / KR / JP+EN ...(决定音素语言)。 is_ai: True=VOCALOID6 AI 歌手;False=经典 V4X/V3 歌手。 name: 轨道名,缺省用歌手名。 base_voice: AI 轨底层 V4X 音色(一般保持默认即可)。 comp_id: 当 singer 不在已知表里时手动指定其 compID。
新建一个空白 VOCALOID 工程,返回 project_id 与工程概要。 参数: title: 工程标题(导出前必须有)。 tempo: 速度 BPM。 numerator/denominator: 拍号,例如 4/4、3/4、6/8。 之后用 add_singer_track 加歌手轨、add_notes 写音符、export_project 导出。
修改单个音符的某些字段(只传需要改的)。number 可填数字或音名。
导出工程为 .vpr 文件。若已有来源工程,则保留内嵌音频等附属文件(无损导出)。
Output schemas not formally documented. Responses inferred from code (_summary, add_notes return dicts). LLMs cannot plan downstream calls without knowing field names and types.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). Tools like remove_note (DESTRUCTIVE) and export_project (WRITE) lack explicit risk markers. Agents cannot distinguish safe reads from irreversible writes.
Parameter constraints missing. tempo has no range (BPM bounds?), numerator/denominator lack validation (4/4 vs 99/99?), notes array items lack minItems/maxItems. Descriptions mention constraints (e.g., 'velocity 0-127') but not in schema.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 58 | 2026-07-28+ | v2 |
读取某轨某片段的音符列表(供编辑前查看)。返回带音名的可读列表。
获取工程的完整概要(标题、速度、拍号、音色、轨道、片段、音符数等)。
列出内置已知的 VOCALOID 音色(歌手名 -> compID)。 建工程时用这些名字即可,无需手填 compID。名字里带 V6 的是 VOCALOID6 AI 歌手, 带 V4X / V3 的是经典歌手。
解析一个已有的 .vpr 文件到内存会话,返回 project_id 与概要。 解析是无损的:手绘音高曲线 (directPitches)、参数自动化 (controllers)、内嵌音频 等都会保留,编辑后 export_project 能原样带回。
按索引删除一个音符。
设置速度(BPM)。pos>0 可在中途插入变速点。
设置拍号。
移调:把某轨(或指定片段)所有音符上/下移若干半音。 注意:手绘音高曲线 (directPitches) 不会被移调,故对重度手动调音的片段移调 可能使手绘音高与音符错位——一般只对新生成、未手动调音的片段使用。
Error handling is basic. ValueError messages are descriptive but not categorized (retryable vs. fatal). No recovery guidance (e.g., 'Try list_voices() first' when singer not found).
Descriptions in Chinese may reduce clarity for English-speaking LLMs. Descriptions like '列出内置已知的 VOCALOID 音色' are domain-specific and may not translate well in LLM reasoning.