Xiange Mcp

Xiange — 音乐能力 MCP Server

给 AI 用的音乐能力包，通过 MCP 协议暴露六项核心工具：识谱、转谱、乐理校验、记谱规范校验、格式互转、渲染出图。

六工具

统一三件套返回：result（结果）、report（校验报告）、confidence（置信标注）。

快速体验

npm run demo
# 浏览器打开 http://localhost:8080

复现页展示六工具能力，包含交互演示（模拟执行）与验证快速体验（输入 MusicXML → 乐理 + 记谱双校验）。

安装

npm install xiange-mcp

前置依赖

xiange-mcp 包装 Python 端既有工具，需要以下环境：

• Python 3.11+（建议独立环境，如 python3 -m venv xiange-env）
• xiange 工具集（默认路径 ~/xiange/tools/，clone 主仓后指向其 tools 目录；可用 XIANG_MCP_TOOLS 覆盖）
• 可选：SMT 引擎（OMR）、Demucs + Basic Pitch / muscriptor（音频转谱）

环境变量可覆盖默认路径：

配置

Claude Code / Claude Desktop 的 mcpServers 配置示例：

{
  "mcpServers": {
    "xiange-mcp": {
      "command": "npx",
      "args": ["xiange-mcp"],
      "env": {
        "XIANG_MCP_TOOLS": "<绝对路径，指向你的 xiange/tools 目录>"
      }
    }
  }
}

XIANG_MCP_PYTHON 缺省用 PATH 里的 python3，环境特殊时按需覆盖。

开发

git clone https://github.com/ZhongQuinnKing/xiange-mcp
cd xiange-mcp
npm install
npm run dev          # tsx 直接跑
npm run build        # 编译到 dist/
npm start            # 跑编译产物
npm run check        # 类型检查

架构

Claude / MCP 客户端
  ↕ stdio (JSON-RPC)
xiange-mcp (Node.js, @modelcontextprotocol/server)
  ↕ child_process
xiange Python 工具集 (engine_runner / theory_check / notation_check / vv_render ...)

Node.js 层只做 MCP 协议适配与参数校验，算法全在 Python 工具里。包装不重写引擎。

许可证

MIT — 见 LICENSE.md

xiange 工具集本身另有许可，见其 LICENSE.md。

相关链接

• xiange 主仓：github.com/ZhongQuinnKing/xiange
• MCP 协议：modelcontextprotocol.io