内容
# mcp-markdown-tools
MCP（模型上下文协议）服务器，提供用于处理 Markdown 内容的工具。通过任何与 MCP 兼容的客户端，以编程方式分析、检查、格式化和生成 Markdown。
## 工具
### 生成目录
从 Markdown 标题生成目录。配置最小/最大标题深度，并选择有序或无序列表输出。
### 检查 Markdown
检查 Markdown 中常见的问题，包括损坏的链接语法、标题层次结构冲突、尾部空格、缺少图像替代文本、不一致的列表标记和过多的空行。
### 格式化 Markdown
格式化和美化 Markdown 内容。标准化标题样式（将 setext 转换为 ATX）、修复标题和块周围的间距、对齐表格列，并在可配置的宽度处换行。
### Markdown 统计
从 Markdown 内容中计算详细统计信息：字数、字符数、估计阅读时间、按级别划分的标题、链接数、图像数、代码块数（带有语言分布）、列表项、引用块和段落数。
### 生成表格
从 JSON 数据生成格式化的 Markdown 表格。支持列选择、自定义标题标签和每列对齐（左、中、右）。
## 安装
```bash
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`
```json
{
"mcpServers": {
"markdown-tools": {
"command": "node",
"args": ["D:/products/mcp-servers/mcp-markdown-tools/dist/index.js"]
}
}
}
```
## 与 Claude Code 一起使用
使用 Claude Code CLI 添加服务器：
```bash
claude mcp add markdown-tools node D:/products/mcp-servers/mcp-markdown-tools/dist/index.js
```
或将其添加到您的 `.mcp.json` 配置中：
```json
{
"mcpServers": {
"markdown-tools": {
"command": "node",
"args": ["D:/products/mcp-servers/mcp-markdown-tools/dist/index.js"]
}
}
}
```
## 开发
```bash
npm install
npm run build
npm start
```
## 许可证
MIT
