一套专门用于 Markdown 文档处理的 Model Context Protocol (MCP) 服务器集合，为 TRAE IDE 提供强大的 Markdown 文档处理能力。包含 TOC 服务器和编辑器服务器两个组件。
可以先阅读 从零构建 MCP 服务：为 TRAE IDE 添加智能 Markdown TOC 处理能力 以及智能体如何高效处理 Markdown：结构化解析与语义编辑方案来了解背后的故事！
| 功能模块 | 主要特性 | 详细说明 |
|---|---|---|
| 提取文档目录 | 自动识别 Markdown 标题 | 智能解析文档中的各级标题结构 |
| 生成层级目录结构 | 构建完整的目录层次关系 | |
| 包含行号信息 | 提供精确的标题位置信息 | |
| 检查编号问题 | 检测重复编号 | 识别文档中重复的章节编号 |
| 发现不连续编号 | 发现跳跃或缺失的编号序列 | |
| 分析格式问题 | 检查编号格式的一致性 | |
| 生成目录内容 | 创建格式化 TOC | 生成美观的目录内容 |
| 支持多种输出格式 | 提供 Markdown、HTML、文本格式 | |
| 可自定义深度 | 灵活控制目录显示层级 |
| 功能模块 | 主要特性 | 详细说明 |
|---|---|---|
| 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/ # 测试报告
请参考 安装说明 进行环境配置。
请参考 测试说明 进行测试。
请参考 使用说明 进行配置。