Markdown TOC MCP Server

一个专门用于 Markdown 文档目录分析和处理的 Model Context Protocol (MCP) 服务器，为 TRAE IDE 提供强大的 Markdown 文档处理能力。

可以先阅读 从零构建 MCP 服务：为 TRAE IDE 添加智能 Markdown TOC 处理能力 来了解背后的故事！

1. 功能说明

MCP 工具唤醒方法：

或者直接：

2. 项目结构

3. TRAE MCP 配置

请参考 安装说明 进行安装和配置。

4. 测试说明

请参考 测试说明 进行测试。

5. 功能详细说明

5.1 extract_markdown_toc

从 Markdown 文档中提取目录结构。

参数：

• file_path (string, 必需): Markdown 文件路径

• output_format (string, 可选): 输出格式，可选值：json, text, markdown，默认为 json

• max_depth (integer, 可选): 最大提取深度，默认为 6

• min_depth (integer, 可选): 最小提取深度，默认为 1

• include_line_numbers (boolean, 可选): 是否包含行号，默认为 false

示例：

5.2 analyze_numbering_issues

分析 Markdown 文档中的编号问题。

功能说明：

该工具会智能识别文档中的有编号标题和无编号标题，只对有编号的标题进行编号问题分析。无编号标题（如以 emoji、中文、纯文本开头的标题）不会参与编号连续性检查，避免误报。

参数：

• file_path (string, 必需): Markdown 文件路径

• check_types (array, 可选): 检查类型，可选值：duplicates, discontinuous，默认为 ["duplicates", "discontinuous"]

行为逻辑：

• duplicates: 检查是否存在重复的编号（如两个 "1.1" 标题）

• discontinuous: 检查编号是否连续（如 "1.1" 后直接跟 "1.3"，缺少 "1.2"）

• 只分析实际有编号的标题，忽略无编号标题

• 支持多种编号格式：数字编号（1.、1.1）、中文编号（一、二）等

示例：

5.3 generate_toc

生成格式化的 TOC 内容供插入文档。

参数：

• file_path (string, 必需): Markdown 文件路径

• format_type (string, 可选): 输出格式，可选值：markdown, html, text，默认为 markdown

• include_links (boolean, 可选): 是否包含链接（仅对 markdown 格式有效），默认为 true

• max_level (integer, 可选): 最大包含的标题级别，默认为 6

示例：

6. 开发和调试

6.1 开发环境设置

6.2 调试模式

在 config/config.yaml 中启用调试模式：

6.3 日志分析

查看详细日志：

7. 常见问题

问题：服务器启动失败：

问题：文件权限错误：

问题：编码错误：

服务器支持多种编码格式（UTF-8、GBK 等），如果遇到编码问题，请确保文件编码正确。