Unmarkdown

Unmarkdown MCP Server

一个 Model Context Protocol（MCP）服务，可将 AI 助手连接到 Unmarkdown API。你可以在 Claude、Cursor、VS Code 或任何兼容 MCP 的客户端中，将 Markdown 转换为格式精美的文档、管理文档库，并将页面发布到网络。

另有以下形式： Chrome 扩展 | Web 应用 | REST API

功能

• 将 Markdown 转换为适用于 8 种目标的样式化 HTML：Google Docs、Word、Slack、OneNote、Email、纯文本、通用 HTML 和原始 HTML
• 62 种视觉模板，支持浅色和深色主题（Swiss、Executive、Terminal、GitHub 等）
• 在 Unmarkdown 文档库中创建、读取、更新文档，并按文件夹整理
• 发布文档，生成可分享的公开 URL，格式为 unmarkdown.com/d/your-slug
• 跟踪 API 用量和当前计费周期的配额

安装

Claude Desktop / Claude for macOS

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

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "unmarkdown": {
      "command": "npx",
      "args": ["-y", "@un-markdown/mcp-server"],
      "env": {
        "UNMARKDOWN_API_KEY": "um_your_api_key_here"
      }
    }
  }
}

Cursor

添加到 Cursor MCP 设置（.cursor/mcp.json）：

{
  "mcpServers": {
    "unmarkdown": {
      "command": "npx",
      "args": ["-y", "@un-markdown/mcp-server"],
      "env": {
        "UNMARKDOWN_API_KEY": "um_your_api_key_here"
      }
    }
  }
}

VS Code

添加到 VS Code MCP 设置（.vscode/mcp.json）：

{
  "servers": {
    "unmarkdown": {
      "command": "npx",
      "args": ["-y", "@un-markdown/mcp-server"],
      "env": {
        "UNMARKDOWN_API_KEY": "um_your_api_key_here"
      }
    }
  }
}

全局安装

如果你更愿意全局安装，而不是使用 npx：

npm install -g @un-markdown/mcp-server

然后使用 unmarkdown-mcp 作为命令，而不是 npx：

{
  "mcpServers": {
    "unmarkdown": {
      "command": "unmarkdown-mcp",
      "env": {
        "UNMARKDOWN_API_KEY": "um_your_api_key_here"
      }
    }
  }
}

配置

必填

变量	说明
UNMARKDOWN_API_KEY	你的 Unmarkdown API 密钥（以 um_ 开头）。在 Unmarkdown 账户的 Settings > API 中获取。

可选

变量	说明	默认值
UNMARKDOWN_API_URL	自定义 API 基础 URL	https://api.unmarkdown.com

使用示例

示例 1：将会议记录草稿转换为适用于 Google Docs 的格式

“将这段 Markdown 使用 Executive 模板转换为适用于 Google Docs 的格式：

# Q1 Planning Meeting

## Attendees
- Sarah Chen (Product)
- Mike Torres (Engineering)
- Lisa Park (Design)

## Action Items
- [ ] Finalize roadmap by Friday
- [ ] Schedule design review for new dashboard
- [ ] Update stakeholder presentation
```”

Claude 将使用 convert_markdown 工具，设置 destination: "google-docs" 和 template_id: "executive"，并返回可直接粘贴到 Google Docs 的样式化 HTML，其中包含规范的标题、字体和颜色。

示例 2：在文件夹中创建文档

“在我的 Release Notes 文件夹中创建一个名为 ‘API Changelog - February 2026’ 的新文档，内容如下，然后发布它。”

Claude 将：

1. 使用标题、Markdown 内容和 folder: "Release Notes" 调用 create_document
2. 使用返回的文档 ID 调用 publish_document

文档会直接创建在指定文件夹中，你会收到一个可访问的 URL，例如 https://unmarkdown.com/d/api-changelog-february-2026。

示例 3：更新并移动文档

“将 Q4 报告移到 Archive 文件夹，并更新其标题。”

Claude 将：

1. 调用 list_documents 查找文档
2. 使用新标题和 folder: "Archive" 调用 update_document

示例 4：为 Slack 转换 Markdown 格式

“将这份项目更新转换为 Slack 格式，让我粘贴到团队频道时显示效果更好。”

Claude 使用 convert_markdown，并设置 destination: "slack"，生成针对 Slack 渲染优化的输出（支持粗体、列表、代码块和 emoji）。

示例 5：检查 API 使用情况

“我这个月用了多少次 API 调用？”

Claude 调用 get_usage，并返回你当前的使用次数、月度限额和计费周期。

工具参考

工具	描述	只读	幂等
convert_markdown	将 Markdown 转换为适用于 8 种目标格式的样式化 HTML	是	是
create_document	在你的文档库中创建新文档（可选放入文件夹）	否	否
list_documents	分页列出已保存的文档（可选按文件夹筛选）	是	是
get_document	按 ID 获取完整内容的文档	是	是
update_document	修改文档的标题、内容、模板、元数据或文件夹	否	是
publish_document	将文档发布到可共享的公开 URL	否	是
get_usage	查看当前计费月份的 API 配额	是	是

目标格式

convert_markdown 工具支持以下输出格式：

目标格式	描述
google-docs	针对粘贴到 Google Docs 中进行优化
word	为 Microsoft Word 排版
slack	兼容 Slack 的格式
onenote	兼容 Microsoft OneNote
email	适合电子邮件客户端的 HTML
plain-text	带 ASCII 格式的纯文本
generic	通用样式化 HTML
html	原始 HTML 输出

模板

将任意模板 ID 传递给 convert_markdown、create_document 或 update_document。常用模板包括：

模板	类别
swiss	免费（默认）
mono	免费
github	免费
terminal	免费
executive	商务（Pro）
consulting	商务（Pro）
startup	商务（Pro）

可在 unmarkdown.com/templates 浏览全部 62 种模板。

API 限制

计划	每月 API 调用次数	速率限制
免费	1,000	10 req/sec
Pro（年度套餐 $8/月）	10,000	30 req/sec

超额费用：每增加 1,000 次调用收费 $1.00（仅限 Pro）。免费计划有硬性限额。

隐私

此 MCP 服务会将你的 Markdown 内容和文档数据发送到 Unmarkdown API（api.unmarkdown.com）进行处理。MCP 服务本身不会在本地存储任何数据。所有数据处理均遵循 Unmarkdown Privacy Policy。

具体而言：

• Markdown 内容：通过 convert_markdown 发送的内容会立即处理并返回，不会存储在 Unmarkdown 服务器上。
• 文档：通过 create_document 或 update_document 创建的文档会存储在你的 Unmarkdown 账户中，你可以随时删除。
• API 密钥：用于验证请求，绝不会被记录或共享。

如需查看完整隐私政策，请访问 unmarkdown.com/privacy。

支持

• 问题反馈： github.com/UnMarkdown/mcp-server/issues
• 文档： docs.unmarkdown.com
• API 参考： docs.unmarkdown.com/api/overview
• 联系方式： unmarkdown.com/contact

开发

# Clone the repo
git clone https://github.com/UnMarkdown/mcp-server.git
cd mcp-server

# Install dependencies
npm install

# Build
npm run build

# Run locally (requires API key)
UNMARKDOWN_API_KEY=um_your_key node build/index.js

另请参阅

• Chrome Extension — 检测并转换任意 AI 聊天页面上的 Markdown（ChatGPT、Claude、Gemini）
• Web App — 功能完整的编辑器，提供 62 个模板、发布、AI 操作和分析功能
• REST API — 以编程方式使用所有转换和文档功能
• Smithery — 通过 Smithery MCP 注册表安装
• npm — npm 上的 @un-markdown/mcp-server

许可证

MIT。详情请参阅 LICENSE。