mcpField
M
markdown

markdown

本地服务
github.com/rog0x开发工具132 周前更新
代码仓库

关于 markdown

markdown 是用于程序化分析和编辑 Markdown 的 MCP 服务，提供目录生成、检查、格式化、统计和表格创建工具。

主要功能

  1. 01生成内容目录
  2. 02检查常见 Markdown 问题
  3. 03格式化标题、间距和表格
  4. 04统计内容与文档结构
  5. 05根据 JSON 创建格式化表格

适用场景

  1. 01为文档生成可导航目录
  2. 02发布前检查 Markdown
  3. 03统一文档格式
  4. 04将 JSON 数据转换为 Markdown 表格

MCP 相关

向兼容 MCP 的客户端提供 Markdown 生成、检查、格式化、统计和表格工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "rog0x-markdown": {
      "command": "npx",
      "args": [
        "-y",
        "@rog0x/mcp-markdown-tools"
      ]
    }
  }
}
启动命令npx -y @rog0x/mcp-markdown-tools

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@rog0x/mcp-markdown-tools1.0.2

工具

5

收录的工具列表 · 更新于 2 周前

参数类型必填说明
orderedboolean否使用有序（编号）列表代替无序列表
markdownstring是用于生成目录的 Markdown 内容
maxDepthnumber否要包含的最大标题深度（1-6）
minDepthnumber否要包含的最小标题深度（1-6）

详细介绍

mcp-markdown-tools

一个用于处理 Markdown 内容的 MCP（Model Context Protocol）服务。通过任何兼容 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

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。