Xiange Music MCP server

弦歌 xiange

乐正线·一级

原作者：ZhongQuinnKing（主号署名）

许可：MIT，见 LICENSE.md

商用与合作：请先联系 hello@xinchuan.dev（标题注明【商用授权】或【改编授权】）；也可走本仓库 issue

给主流 AI 用的音乐能力包。姊妹篇：采诗读互联网、拾级陪人、玉尺量文章、弦歌弄音乐。

能力验证：一个真实的钢琴编配项目全程走通（选曲／取源／转谱／出谱），产出全部归本包。 项目本身不是成果，这套可复用的流程与工具才是。

流水线总览

任何输入（糊图/截图/哼唱/一句话/数字文件） → 认曲：低质输入只是"线索"，不硬做（docs/01） → ├─ 【数字源直通线】用户持有数字文件（自打/正版/下载） │ → 验证三件套 → 直用（最快最准） └─ 【搜索线】没有数字源 → 采诗换源：全网搜高质量谱——弹琴吧/B站链/平台矩阵（docs/02） → 源择优：数字源 ＞ 印刷高清 ＞ 印刷普通；手写不用 → 转谱（引擎链＋多引擎共识，docs/03） → 符号层：从原谱图读取回填（连音/力度/踏板/指法） → 精排（Dorico）→ 出谱

每一步都带来源与置信标注。 出库闸：核过的才许标"已验证"，没核的一律标"待核对"（报"已验证"须附标准报告卡，口径见 docs/06）。

快速开始（含依赖）

环境：Python 3.11（参考环境用 conda env music-transcribe）。依赖按工具分档，零依赖件装包即用：

• 零依赖（仅标准库）：记谱两件（notationcheck 体检／notationfix 修复），可直接跑
• 核心档（requirements.txt：music21、numpy）：四级度量报告卡（omreval）、乐理关（theorycheck）、分诊（triage）、体检修整（scoredoctor）、共识系（consensus）、数字源验证三件套（verify）、音频对拍（verifyvs_audio）
• 渲染档（requirements-render.txt：verovio、cairosvg、pillow）：渲染交付（vvrender／renderv4）与 kern 修复（bekern_fix）
• 浏览器档（requirements-browser.txt：playwright）：简谱腿（deliver_dolce）
• 输入路由档（requirements-vision.txt：opencv、numpy）：工具谱种路由、B站提页（biliextract）

一键安装：

bash install.sh core # 按档装：core / render / browser / vision / all bash install.sh all # 四档全装

五分钟上手：

python3 tools/xiange.py doctor # 环境自检（缺什么直接给修复命令） python3 tools/xiange.py check 谱.musicxml # 记谱体检（零依赖，立即可跑） python3 tools/xiange.py selfcheck # 判据级自测全列（一遍看全） （route／fix／export 同壳入口；装不上看 docs/12-故障排查）

自测（判据级二十一套，与 CI 同款）：

for f in tools/tests/test_*.py; do python3 "$f"; done

外部引擎（SMT／Audiveris 等）非 pip 依赖，接入见 docs/03；统一入口 tools/engine_runner.py（引擎注册表与 run.json 留痕）。

常用一条命令：

• 记谱体检：python3 tools/notation_check.py 谱.musicxml
• 谱面体检：python3 tools/score_doctor.py inspect 谱.musicxml
• 谱种路由（入口）：python3 tools/工具_谱种路由.py 谱图.png，一张图先判谱种（五线谱／六线谱／简谱等），再走对应引擎与工序
• 乐理体检：python3 tools/theory_check.py 谱.musicxml（声部交叉／平行五八度／跨度上限可调／密度骤降／时值）
• 成品出包：python3 tools/export_pack.py 谱.musicxml --out 目录 --title 曲名（五线谱三件＋mxl／mid＋简谱三件＋试听＋成品卡＋zip）
• 谱面规范查对：python3 tools/yuchiscorecheck.py 谱.musicxml（谱面规范查对：小节对账／附点越界／连音线闭合／变音记号；只诊断不改谱，与记谱体检分工见规则档）

知识线：直接按 知识/90-音乐问答协议.md 的三层路径执行，零安装。

源获取（复刻线）：依赖外部通道（采诗，开源公开：github.com/ZhongQuinnKing/caishi；各站边界见 docs/02）。没有该通道时的降级路径：只处理本机已有文件，或用公开搜索自行找谱（弹琴吧／B站等直达页面），按 docs/02 的源分级与各站边界走；不静默降级、不虚构来源。

目录

• docs/ 工序文档
• 01-输入处理（低质输入协议：差图＝认曲线索）
• 02-源获取工序（数字源＋平台矩阵＋各站边界）
• 03-引擎链（SMT／oemer 现状与目标）
• 04-质量体系（四道自动关＋人工关＋拒收线＋分级承诺）
• 05-交付标准
• 06-评测口径（四级度量＋报告卡＋域内泛化分栏）
• 07-已知局限（手写不做／低清拒收／符号层天花板）
• 08-数字源验证教程（verify 三件套逐步命令）
• 09-环境兼容矩阵（三平台实测）
• 10-能力状态（各线：已验证／在办）
• 11-出谱平替评估（MuseScore 4 第一轮实测）

Shortened. The full README is on GitHub.