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/               # 測試報告