mcp-markdown-tools

一个提供处理 Markdown 内容工具的 MCP（模型上下文协议）服务器。通过任何兼容 MCP 的客户端，以编程方式分析、检查、格式化和生成 Markdown。

工具

generate_toc

根据 Markdown 标题生成目录。可配置最小/最大标题深度，并可在有序列表或无序列表输出之间进行选择。

lint_markdown

检查 Markdown 中的常见问题，包括损坏的链接语法、标题层级违规、行尾空格、缺失的图片替代文本、不一致的列表标记以及过多的空行。

format_markdown

格式化并美化 Markdown 内容。规范化标题样式（将 setext 转换为 ATX），修复标题和块周围的间距，对齐表格列，并按可配置的宽度换行长文本。

markdown_stats

计算 Markdown 内容的详细统计信息：字数、字符数、预计阅读时间、各级标题数量、链接数、图片数、包含语言分布的代码块数、列表项、引用块和段落数。

generate_table

根据 JSON 数据生成格式化的 Markdown 表格。支持列选择、自定义表头标签以及每列的对齐方式（左对齐、居中、右对齐）。

安装

npm install
npm run build

在 Claude Desktop 中使用

将以下内容添加到您的 Claude Desktop 配置文件中：

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "markdown-tools": {
      "command": "node",
      "args": ["D:/products/mcp-servers/mcp-markdown-tools/dist/index.js"]
    }
  }
}

在 Claude Code 中使用

使用 Claude Code CLI 添加服务器：

claude mcp add markdown-tools node D:/products/mcp-servers/mcp-markdown-tools/dist/index.js

或者将其添加到您的 .mcp.json 配置文件中：

{
  "mcpServers": {
    "markdown-tools": {
      "command": "node",
      "args": ["D:/products/mcp-servers/mcp-markdown-tools/dist/index.js"]
    }
  }
}

开发

npm install
npm run build
npm start

许可证

MIT