Provides read-only access to GitHub, allowing search of MDMods repositories and retrieval of their text files for modding reference.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Muse Dash Mod MCP Create a new mod project called MyMod"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
一个面向 Muse Dash 模组开发的本地 MCP（Model Context Protocol）服务器，使用 Python + FastMCP 编写，任何支持本地 stdio MCP 传输的客户端都可以连接。
项目脚手架：封装固定版本 MuseDash.Mod.Template 1.0.4，创建 C# / .NET 6 Muse Dash 模组项目
开发知识库：提供 MelonLoader、Harmony、IL2CPP、MuseDashMirror、模板参数和构建部署文档
构建与部署：编译模组、诊断本机环境；明确调用 deploy_mod 才会复制 DLL 到游戏 Mods
社区参考：只读检索 MDMods 仓库和源码文件
Related MCP server: MCP Server Creator
Windows
Python 3.10+
.NET SDK 8（模板生成的项目目标为 net6.0）
Muse Dash + MelonLoader 0.6.1
MD_DIRECTORY 环境变量指向游戏目录，例如：
$env:MD_DIRECTORY = 'G:\Steam\steamapps\common\Muse Dash'服务器也会尝试探测常见 Steam 安装路径，并支持 MUSE_DASH_PATH 作为备用变量。
cd C:\path\to\musedash-mod-mcp
.venv\Scripts\python.exe -m pip install -e .如果还没有虚拟环境：
python -m venv .venv
.venv\Scripts\python.exe -m pip install -e .可选：设置 GITHUB_TOKEN（或 GH_TOKEN）以提高 GitHub API 限额。
服务器使用标准本地 stdio transport。直接运行：
$env:PYTHONPATH = 'C:\path\to\musedash-mod-mcp\src'
C:\path\to\musedash-mod-mcp\.venv\Scripts\python.exe -m musedash_mod_mcp.server客户端配置通常包含以下字段：
command：Python 可执行文件的绝对路径
args：["-m", "musedash_mod_mcp.server"]
cwd：项目根目录
env.PYTHONPATH：项目的 src 目录
不同客户端的配置文件和 JSON 外壳名称不同，请以对应客户端的 MCP 设置页面/文档为准。下面是常见客户端采用的配置对象示例：
{
"musedash-mod": {
"command": "C:\\path\\to\\musedash-mod-mcp\\.venv\\Scripts\\python.exe",
"args": ["-m", "musedash_mod_mcp.server"],
"cwd": "C:\\path\\to\\musedash-mod-mcp",
"env": {
"PYTHONPATH": "C:\\path\\to\\musedash-mod-mcp\\src"
}
}
}工具 | 作用 |
| 创建模组项目并填充作者/版本元数据 |
| 隔离构建并返回 DLL、错误和日志；不会写入真实 Mods |
| 构建后显式、原子地复制主 DLL 到真实 Mods 目录 |
| 启动 MuseDash.exe（仅在用户明确要求时调用） |
| 检查游戏、MelonLoader、dotnet、模板和已安装 DLL |
| 列出内置文档主题 |
| 读取一个主题 |
| 搜索 MDMods 仓库 |
| 读取 MDMods 仓库中的文本文件 |
此外还提供 knowledge://musedash/{topic} resources 和 new_mod_workflow prompt。
$env:PYTHONPATH = "$PWD\src"
.venv\Scripts\python.exe tests\smoke_test.py端到端测试建议使用临时输出目录。模板默认的空 Patches/Patch.cs 是示例占位符，若要直接编译空项目，请设置 patching=false，或先填写真实的 Harmony 目标类型和方法。
search_mdmods_repos 和 get_mdmods_repo_file 只读访问 GitHub。
build_mod 使用外部临时目录作为模板复制目标，并清除 MD_DIRECTORY；它不是任意 MSBuild 项目的安全沙箱，仍应只构建可信项目。
deploy_mod 会覆盖 Mods 中同名 DLL，使用前应确认目标路径。
launch_game 会启动外部游戏进程，应在用户明确要求后调用。
Build a Muse Dash mod project and report generated DLLs and compiler errors.
Inputs: project_path (required), configuration. Returns: object
Create a C# Muse Dash mod using MuseDash.Mod.Template.
Inputs: mod_name (required), author, setting, version, +3 more. Returns: object
Build and explicitly copy the primary mod DLL into the game's Mods directory.
Inputs: project_path (required), configuration. Returns: object
Inspect MD_DIRECTORY, MelonLoader, dotnet, the template, and installed mod DLLs.
Inputs: no named parameters. Returns: object
Read a text file from an MDMods GitHub repository.
Inputs: repo (required), path. Returns: object
Read one built-in documentation topic by its slug.
Inputs: topic (required). Returns: result
Launch MuseDash.exe for local mod testing without waiting for it to exit.
Inputs: no named parameters. Returns: object
List the built-in Muse Dash mod development documentation topics.
Inputs: no named parameters. Returns: result
Search read-only MDMods GitHub repository metadata.
Inputs: limit, query. Returns: object
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 9 tools
Each tool has a distinct purpose: creating a project, building, deploying, launching, inspecting the environment, searching repositories, reading files, and accessing docs. There is no overlap; even build_mod and deploy_mod are clearly separated by deploy's explicit copy-to-game-directory behavior.
All tool names follow a consistent verb_noun pattern in lowercase with underscores (create_mod_project, build_mod, deploy_mod, launch_game, get_environment_info, search_mdmods_repos, get_mdmods_repo_file, list_modding_docs, get_modding_doc). The mix of verbs (create, build, deploy, launch, get, search, list) is predictable and readable.
The 9 tools are well-scoped for a modding workflow, covering the core development cycle (create, build, deploy, launch) plus environment inspection, repository browsing, and documentation access. The count is within the ideal 3-15 range and feels neither sparse nor bloated.
The toolset covers the entire mod lifecycle from creation to testing, with environment diagnostics and documentation support. Minor gaps exist, such as no explicit uninstall/remove tool or dependency management, but these are not critical to the primary workflow and can be worked around.
Create, deploy, and operate MCP servers directly from your GitHub repositories.
A MCP server built for developers enabling Git based project management with project and personal…
MCP server for developer documentation, generated by doc2mcp.
The official MCP Server for the Mux API
