Markdown-MCP: Tool for TOC Extraction, Numbering Check & Semantic Editing

Markdown MCP

A set of MCP servers specifically for Markdown document processing, providing functions such as table of contents extraction, numbering check, and semantic editing

Developer tools Note-taking tools #Document Processing #Table of Contents Generation #Format Optimization .Python

rating : 2 points

downloads : 5.5K

update time : 2025-11-12

Open Site

What is Markdown MCP Servers?

Markdown MCP Servers is a set of intelligent document processing tools based on the Model Context Protocol, specifically providing automated processing capabilities for Markdown documents. It consists of two core components: the TOC server is used to automatically generate the document table of contents and check numbering issues, and the editor server provides intelligent editing and format optimization functions.

How to use Markdown MCP Servers?

After configuring and starting the MCP server in the TRAE IDE, the system will automatically recognize Markdown documents and provide intelligent processing functions. You can generate the table of contents, check the document structure, perform intelligent editing, etc. through simple commands or interface operations.

Applicable Scenarios

Suitable for scenarios that require processing structured Markdown documents, such as technical document writing, project document management, academic paper writing, and blog content creation. It is particularly suitable for the structured management and maintenance of large documents.

Main Features

Intelligent Table of Contents Extraction

Automatically identify all titles in the Markdown document, build a complete hierarchical table of contents structure, and provide accurate line number position information

Numbering Issue Detection

Intelligently detect issues such as duplicate numbering, discontinuous numbering, and inconsistent formatting in the document to ensure the standardization of the document structure

Multi - format Table of Contents Generation

Support the generation of table of contents content in multiple formats such as Markdown, HTML, and plain text, and allow customizing the display hierarchy depth

Structured Conversion

Perform bidirectional conversion between Markdown and the Structured Intermediate Representation (SIR) to maintain the integrity of the document structure

Semantic Editing

Support advanced editing functions such as intelligent modification of title text and levels, chapter insertion, and automatic numbering rearrangement

Document Structure Analysis

Deeply analyze the integrity of the document structure, detect numbering issues, and provide format optimization suggestions

Advantages

Automated processing: Automatically recognize and generate the document structure, reducing manual operations

Intelligent detection: Can discover numbering and formatting issues that are difficult to detect manually

Multi - format support: Provide multiple output formats to adapt to different usage scenarios

Maintain structure: Maintain the integrity and consistency of the document structure during the editing process

Easy to integrate: Specifically designed for the TRAE IDE, easy to integrate and use

Limitations

Dependence on standard formats: Support for non - standard Markdown formats may be limited

Performance for large documents: Optimization may be required when processing extremely large documents

Specific environment: Mainly targeted at the TRAE IDE environment, other editors need adaptation

Learning cost: Advanced functions require a certain amount of learning time to master

How to Use

Environment Configuration

Refer to the installation instruction document to complete the installation and configuration of the Python environment and dependent packages

Server Startup

Use the provided startup script to start the MCP server in the TRAE IDE

Function Usage

Open a Markdown document in the TRAE IDE and use the corresponding commands or interface operations to call various functions

Usage Examples

Technical Document Table of Contents Generation

Automatically generate a complete table of contents structure for large technical documents to facilitate navigation and reading

Academic Paper Numbering Check

Check whether the chapter numbering in academic papers is continuous and standard

Blog Article Structure Optimization

Perform structured editing on blog articles to optimize the title hierarchy and content organization

Frequently Asked Questions

Which Markdown formats does the MCP server support?

How to handle performance issues for large documents?

Can the style and format of the table of contents be customized?

Will editing operations damage the original document format?

How to report issues or request new features?

Related Resources

Installation Instruction Document

Detailed instructions on environment configuration and installation steps

Usage Guide

Complete instructions on function usage and configuration guide

Technical Blog Article

Understand the technical story behind MCP service integration

Intelligent Agent Processing Solution

Deeply understand the technical solution of structured parsing and semantic editing

Testing Instruction

Instructions on testing methods and test reports

🚀 Markdown MCP Servers

A collection of Model Context Protocol (MCP) servers dedicated to Markdown document processing, providing powerful Markdown document handling capabilities for the TRAE IDE. It includes two components: the TOC server and the editor server.

You can first read and to understand the story behind it!

🚀 Quick Start

To get started, you can refer to the relevant documents for environment configuration, testing, and usage:

Environment Configuration: Setup Instructions
Testing: Testing Instructions
Usage: Usage Instructions

✨ Features

✨ Markdown TOC MCP Server

Function Module	Main Features	Detailed Description
Extract Document TOC	Automatically identify Markdown headings	Intelligently parse the hierarchical structure of headings in the document
	Generate a hierarchical TOC structure	Build a complete hierarchical relationship for the TOC
	Include line number information	Provide precise location information for headings
Check Numbering Issues	Detect duplicate numbers	Identify duplicate chapter numbers in the document
	Find discontinuous numbers	Discover skipped or missing number sequences
	Analyze formatting issues	Check the consistency of numbering formats
Generate TOC Content	Create a formatted TOC	Generate an aesthetically pleasing TOC
	Support multiple output formats	Provide Markdown, HTML, and text formats
	Customizable depth	Flexibly control the display level of the TOC

✨ Markdown Editor MCP Server

Function Module	Main Features	Detailed Description
SIR Conversion	Bidirectional format conversion	Markdown ↔ Structured Intermediate Representation
	Maintain format	Keep the document structure intact during conversion
	High-performance processing	Support efficient conversion of large documents
Semantic Editing	Intelligent heading editing	Support modification of heading text and levels
	Insert chapters	Insert new chapters at specified positions
	Renumber headings	Automatically renumber document headings
Document Analysis	Structure analysis	Analyze the document structure and integrity
	Numbering check	Detect duplicate and discontinuous numbering issues
	Format optimization	Optimize document format and readability

📚 Documentation

📚 Project Structure

markdown-mcp/
├── README.md                    # Project description document
├── LICENSE                      # License file
├── requirements.txt             # Python dependencies
├── setup.py                     # Installation configuration file
├── run_tests.py                 # Test running script
├── start_mcp_for_trae.sh       # TRAE IDE startup script
├── stop_mcp_for_trae.sh        # TRAE IDE stop script
├── config/                      # Configuration file directory
│   ├── config.yaml             # Main configuration file
│   ├── toc_mcp_config.json     # TOC server TRAE IDE configuration
│   └── editor_mcp_config.json  # Editor server TRAE IDE configuration
├── src/                         # Source code directory
│   ├── __init__.py
│   ├── markdown_toc/           # TOC core module
│   │   ├── __init__.py
│   │   └── extractor.py        # TOC extractor
│   ├── markdown_editor/        # Editor core module
│   │   ├── __init__.py
│   │   ├── ast_parser.py       # AST parser
│   │   ├── semantic_editor.py  # Semantic editor
│   │   └── format_optimizer.py # Format optimizer
│   └── server/                 # Server module
│       ├── __init__.py
│       ├── toc_mcp_server.py   # TOC MCP server main program
│       └── editor_mcp_server.py # Editor MCP server main program
├── tests/                      # Test file directory
│   ├── __init__.py
│   ├── fixtures/               # Test data
│   ├── toc/                    # TOC server tests
│   │   ├── test_extractor.py   # Extractor tests
│   │   └── test_integration.py # Integration tests
│   ├── editor/                 # Editor server tests
│   │   ├── test_ast_parser.py  # AST parser tests
│   │   ├── test_semantic_editor.py # Semantic editor tests
│   │   └── test_format_optimizer.py # Format optimizer tests
│   └── test_config.py         # Test configuration
└── docs/                       # Documentation directory
    ├── setup.md               # Installation instructions
    ├── usage.md               # Usage guide
    ├── testing.md             # Testing instructions
    └── reports/               # Test reports