一个高效处理 Markdown 文档的 MCP 服务器。

特性

• 检查 Markdown 文档的标题行符号#和编号的有效性
• 创建和清除 Markdown 文档的标题编号，支持阿拉伯数字和中文数字
• 高效和低成本：全文批量处理，避免面对大文档时 AI 逐次分块处理的默认行为，文件越大效果越明显，加快处理速度的同时节省 token 消耗
• 超轻量：基于 Rust 开发的二进制程序，CPU 占用和驻留内存可忽略不计
• 内置了一个基于 MST (Markdown structured tree) 的 Markdown 文档解析器和编译器

用法

安装

Docker 模式

将由 Docker 托管的 MCP 服务器加入到你的 LLM 助手应用中，配置文件如下：

{
  "mcpServers": {
    "markdown-tools": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--init",
        "-v",
        "/Users:/Users",
        "bigyao25/mcp-markdown-tools"
      ]
    }
  }
}

出于安全目的，你可以通过修改挂载目录来限制 MCP 的访问权限。

二进制程序模式

从 Release 下载适合你运行环境的最新的稳定版二进制文件

在你的 LLM 助手应用中加入本 MCP 服务器，配置文件如下：

{
  "mcpServers": {
    "markdown-tools": {
      "command": "/real/path/to/mcp-markdown-tools"
    }
  }
}

对话示例

• 检查 /home/docs/lorem.md 标题级别的逻辑
• 清除 /home/docs/lorem.md 所有标题中的编号
• 将 /home/docs/lorem.md 二级及其以下的标题添加编号，另存为 lorem-numed.md
• 请帮我把 /home/docs/doc1-cn.md 的标题添加中文编号，首行不加，另存为：doc1-cn-numed.md
• 将 /home/docs/lorem.md 中的图片全部转为本地，另存为 /home/docs/lorem_local.md。

License

This project is licensed under the MIT License.