Markdown-MCP - 支持目录提取、编号检查和语义编辑的Markdown处理MCP工具

探索

Markdown MCP

一套专门用于Markdown文档处理的MCP服务器集合，提供目录提取、编号检查和语义编辑等功能

开发者工具笔记工具 #文档处理 #目录生成 #格式优化 .Python

评分 : 2分

下载量 : 3.9K

更新时间 : 2025-11-12

打开站点

什么是Markdown MCP Servers?

Markdown MCP Servers是一套基于Model Context Protocol的智能文档处理工具，专门为Markdown文档提供自动化处理能力。它包含两个核心组件：TOC服务器用于自动生成文档目录和检查编号问题，编辑器服务器提供智能编辑和格式优化功能。

如何使用Markdown MCP Servers?

在TRAE IDE中配置并启动MCP服务器后，系统会自动识别Markdown文档并提供智能处理功能。您可以通过简单的命令或界面操作来生成目录、检查文档结构、进行智能编辑等。

适用场景

适合技术文档编写、项目文档管理、学术论文撰写、博客内容创作等需要处理结构化Markdown文档的场景。特别适用于大型文档的结构化管理和维护。

主要功能

智能目录提取

自动识别Markdown文档中的所有标题，构建完整的层级目录结构，并提供精确的行号位置信息

编号问题检测

智能检测文档中的重复编号、不连续编号和格式不一致问题，确保文档结构的规范性

多格式目录生成

支持生成Markdown、HTML、纯文本等多种格式的目录内容，可自定义显示层级深度

结构化转换

在Markdown和结构化中间表示(SIR)之间进行双向转换，保持文档结构完整性

语义化编辑

支持标题文本和级别的智能修改、章节插入、自动编号重排等高级编辑功能

文档结构分析

深入分析文档结构完整性，检测编号问题，并提供格式优化建议

优势

自动化处理：自动识别和生成文档结构，减少手动操作

智能检测：能够发现人工难以察觉的编号和格式问题

多格式支持：提供多种输出格式，适应不同使用场景

保持结构：在编辑过程中保持文档结构的完整性和一致性

易于集成：专为TRAE IDE设计，集成简单使用方便

局限性

依赖规范格式：对非标准Markdown格式的支持可能有限

大型文档性能：处理超大型文档时可能需要优化

特定环境：主要针对TRAE IDE环境，其他编辑器需要适配

学习成本：高级功能需要一定的学习时间来掌握

如何使用

环境配置

参考安装说明文档完成Python环境和依赖包的安装配置

服务器启动

使用提供的启动脚本在TRAE IDE中启动MCP服务器

功能使用

在TRAE IDE中打开Markdown文档，使用相应的命令或界面操作来调用各种功能

使用案例

技术文档目录生成

为大型技术文档自动生成完整的目录结构，便于导航和阅读

学术论文编号检查

检查学术论文中的章节编号是否连续和规范

博客文章结构优化

对博客文章进行结构化编辑，优化标题层次和内容组织

常见问题

MCP服务器支持哪些Markdown格式？

如何处理大型文档的性能问题？

能否自定义目录的样式和格式？

编辑操作是否会破坏原有文档格式？

如何报告问题或请求新功能？

🚀 Markdown MCP 服务器

一套专门用于 Markdown 文档处理的 Model Context Protocol (MCP) 服务器集合，为 TRAE IDE 提供强大的 Markdown 文档处理能力。包含 TOC 服务器和编辑器服务器两个组件。

可以先阅读以及来了解背后的故事！

🚀 快速开始

若想了解本项目背后的故事，可以先阅读以及。

✨ 主要特性

Markdown TOC MCP Server

属性	详情
提取文档目录	自动识别 Markdown 标题，智能解析文档中的各级标题结构；生成层级目录结构，构建完整的目录层次关系；包含行号信息，提供精确的标题位置信息
检查编号问题	检测重复编号，识别文档中重复的章节编号；发现不连续编号，发现跳跃或缺失的编号序列；分析格式问题，检查编号格式的一致性
生成目录内容	创建格式化 TOC，生成美观的目录内容；支持多种输出格式，提供 Markdown、HTML、文本格式；可自定义深度，灵活控制目录显示层级

Markdown Editor MCP Server

属性	详情
SIR 转换	双向格式转换，Markdown ↔ 结构化中间表示；格式保持，转换过程中保持文档结构完整性；高性能处理，支持大型文档的高效转换
语义编辑	智能标题编辑，支持标题文本和级别的修改；章节插入，在指定位置插入新的章节；编号重排，自动重新编号文档标题
文档分析	结构分析，分析文档结构和完整性；编号检查，检测编号重复和不连续问题；格式优化，优化文档格式和可读性

📚 详细文档

项目结构

markdown-mcp/
├── README.md                    # 项目说明文档
├── LICENSE                      # 许可证文件
├── requirements.txt             # Python 依赖包
├── setup.py                     # 安装配置文件
├── run_tests.py                 # 测试运行脚本
├── start_mcp_for_trae.sh       # TRAE IDE 启动脚本
├── stop_mcp_for_trae.sh        # TRAE IDE 停止脚本
├── config/                      # 配置文件目录
│   ├── config.yaml             # 主配置文件
│   ├── toc_mcp_config.json     # TOC 服务器 TRAE IDE 配置
│   └── editor_mcp_config.json  # 编辑器服务器 TRAE IDE 配置
├── src/                         # 源代码目录
│   ├── __init__.py
│   ├── markdown_toc/           # TOC 核心模块
│   │   ├── __init__.py
│   │   └── extractor.py        # TOC 提取器
│   ├── markdown_editor/        # 编辑器核心模块
│   │   ├── __init__.py
│   │   ├── ast_parser.py       # AST 解析器
│   │   ├── semantic_editor.py  # 语义编辑器
│   │   └── format_optimizer.py # 格式优化器
│   └── server/                 # 服务器模块
│       ├── __init__.py
│       ├── toc_mcp_server.py   # TOC MCP 服务器主程序
│       └── editor_mcp_server.py # 编辑器 MCP 服务器主程序
├── tests/                      # 测试文件目录
│   ├── __init__.py
│   ├── fixtures/               # 测试数据
│   ├── toc/                    # TOC 服务器测试
│   │   ├── test_extractor.py   # 提取器测试
│   │   └── test_integration.py # 集成测试
│   ├── editor/                 # 编辑器服务器测试
│   │   ├── test_ast_parser.py  # AST 解析器测试
│   │   ├── test_semantic_editor.py # 语义编辑器测试
│   │   └── test_format_optimizer.py # 格式优化器测试
│   └── test_config.py         # 测试配置
└── docs/                       # 文档目录
    ├── setup.md               # 安装说明
    ├── usage.md               # 使用指南
    ├── testing.md             # 测试说明
    └── reports/               # 测试报告