Skip to main content
Glama
ZhongQuinnKing

xiange-mcp

by ZhongQuinnKing
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

xiange-mcp

ZhongQuinnKing/xiange-mcp MCP server

Xiange — 音乐能力 MCP Server

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

六工具

工具

用途

输入

输出

omr_read

识谱

图片／PDF

MusicXML + MIDI + run.json

audio_transcribe

转谱

音频（wav/mp3/flac）

MIDI + MusicXML

theory_check

乐理校验

MusicXML／MIDI／krn

校验报告（声部交叉／平行五八度／跨度）

notation_check

记谱规范校验

MusicXML

校验报告（符杠／符干／休止／谱表）

convert

格式互转＋移调

MusicXML／MIDI／krn／mxl

目标格式文件

render_score

渲染出图／PDF

MusicXML

SVG／PNG／PDF（逐页）

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

Related MCP server: rhythm-vibe-studio

快速体验

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（音频转谱）

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

变量

默认值

说明

XIANG_MCP_TOOLS

~/xiange/tools/

Python 工具目录

SMT_ROOT

未设置

SMT 引擎仓（可选，未设置时该引擎不可用）

XIANG_MCP_PYTHON

python3

Python 解释器

配置

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。

相关链接

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • rhythm-vibe-studio

    bolabaden
    -
    license
    Not graded
    quality
    Not graded
    maintenance
    MCP server for vibe coding with music, enabling format conversion (LilyPond, MusicXML, MIDI, ABC, etc.), audio-to-sheet transcription, and transposition with robust fallback outputs.
    1
    -

  • midifier

    matheusfillipe
    A
    license
    A
    quality
    B
    maintenance
    MCP server that transcribes songs into multi-track General MIDI files, identifying instruments and structuring tracks. Accepts audio files and manages transcription jobs with queue and ETA.
    3
    1
    MIT