Markdown MCP Servers

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

可以先阅读 从零构建 MCP 服务：为 TRAE IDE 添加智能 Markdown TOC 处理能力 以及智能体如何高效处理 Markdown：结构化解析与语义编辑方案来了解背后的故事！

1. 功能说明

1.1 Markdown TOC MCP Server

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

1.2 Markdown Editor MCP Server

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

2. 项目结构

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/ # 测试报告