Markdown

io.github.rog0x由 GitHub 账号 rog0x 发布v1.0.2更新于 Oct 24, 2026

Markdown TOC, lint, format, stats for AI agents

已验证STDIO仅桌面文件与存储开发者工具

概览

AI 生成的概览

让助手分析、检查、格式化和生成 Markdown 内容，包括目录和表格。

可以做什么
提供五个 Markdown 工具：generate_toc 根据标题生成目录，可配置标题深度和有序或无序列表；lint_markdown 检查常见问题，如链接语法错误、标题层级违规、行尾空格、图片缺少替代文本、列表标记不一致和过多空行；format_markdown 美化内容，规范化标题样式、修正间距、对齐表格列并按可配置宽度换行；markdown_stats 统计字数、字符数、预计阅读时间、各级标题、链接、图片、代码块及语言分布、列表项、引用和段落数；generate_table 从 JSON 数据生成格式化表格，支持列选择、自定义表头和列对齐。
适用场景
适合助手处理 Markdown 文档时使用，例如检查一致性、整理格式、生成目录、汇总文档结构，或把 JSON 数据转成 Markdown 表格。
运行要求
通过 npm 包 @rog0x/mcp-markdown-tools 以 stdio 方式在本地运行，需要 Node.js。README 说明了从源码安装和构建，并在客户端配置中注册构建后的入口文件。未声明任何认证、环境变量或请求头。
安装前请注意
这些工具处理传入的 Markdown 内容；format_markdown 会重写内容，覆盖原文件前应先检查输出。未显示需要凭据、付款或向第三方传输数据。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Markdown，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

mcp-markdown-tools

An MCP (Model Context Protocol) server that provides tools for working with Markdown content. Analyze, lint, format, and generate Markdown programmatically through any MCP-compatible client.

Tools

generate_toc

Generate a table of contents from markdown headings. Configure minimum/maximum heading depth and choose between ordered or unordered list output.

lint_markdown

Check markdown for common issues including broken link syntax, heading hierarchy violations, trailing whitespace, missing image alt text, inconsistent list markers, and excessive blank lines.

format_markdown

Format and prettify markdown content. Normalizes heading styles (converts setext to ATX), fixes spacing around headings and blocks, aligns table columns, and wraps long lines at configurable width.

markdown_stats

Compute detailed statistics from markdown content: word count, character count, estimated reading time, headings by level, link count, image count, code block count with language distribution, list items, blockquotes, and paragraph count.

generate_table

Generate formatted markdown tables from JSON data. Supports column selection, custom header labels, and per-column alignment (left, center, right).

Installation

bash
npm installnpm run build

Usage with Claude Desktop

Add the following to your Claude Desktop configuration file:

  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
json
{  "mcpServers": {    "markdown-tools": {      "command": "node",      "args": ["D:/products/mcp-servers/mcp-markdown-tools/dist/index.js"]    }  }}

Usage with Claude Code

Add the server using the Claude Code CLI:

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

Or add it to your .mcp.json configuration:

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

Development

bash
npm installnpm run buildnpm start

License

MIT

来源：README.md，提交 387a1c6

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.0.2最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分