Markdown转换服务器

一个连接AI助手与Unmarkdown API的Model Context Protocol (MCP)服务器,用于将Markdown转换为格式精美的文档,并管理文档库和发布网页。

  • by UnMarkdown
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 UnMarkdown/mcp-server

使用说明

取消标记MCP服务器

A. 模型上下文协议 (MCP)服务器,将AI助手连接到 取消降价 API将markdown转换为格式精美的文档,管理您的文档库,并将页面发布到网络上,所有这些都可以在Claude、Cursor、VS Code或任何兼容MCP的客户端中完成。

也可用作: Chrome 扩展 | 网页应用 | REST API

特性

  • 转换降价 转换为8个目标的样式化HTML:谷歌文档、Word、Slack、OneNote、电子邮件、纯文本、通用HTML和原始HTML
  • 62个视觉模板 具有浅色和深色主题(瑞士、行政、终端、GitHub等)
  • 创建、读取、更新 Unmarkdown库中的文档,组织到文件夹中
  • 发布文档 可共享的公共URL unmarkdown.com/d/your-slug
  • 跟踪API使用情况 以及当前计费周期的配额

安装

Claude Desktop/适用于macOS的Claude

将此添加到您的Claude Desktop配置文件中:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 窗户: %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"
      }
    }
  }
}

光标

添加到光标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代码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_).从以下位置获取一个 设置>API 在您的Unmarkdown帐户中。

可选的

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

使用示例

示例1:将会议笔记草稿转换为Google Docs

“取下此标记,并使用Executive模板将其转换为Google文档:

# 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
```"

克劳德将使用 convert_markdown 工具与 destination: "google-docs" 和 template_id: "executive",返回带有适当标题、字体和颜色的样式化HTML,准备粘贴到谷歌文档中。

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

“在我的Release Notes文件夹中创建一个名为“API Changelog-2026年2月”的新文档,其中包含此内容,然后发布。”

克劳德将:

  1. 呼叫 create_document 带有标题、降价内容和 folder: "Release Notes"
  2. 呼叫 publish_document 使用返回的文档ID

文档直接在指定文件夹中创建,您将返回一个实时URL,如下所示 https://unmarkdown.com/d/api-changelog-february-2026.

示例3:更新和移动文档

“将第四季度报告移至“存档”文件夹并更新其标题。”

克劳德将:

  1. 呼叫 list_documents 查找文档
  2. 呼叫 update_document 新标题和 folder: "Archive"

示例4:Slack的格式标记

“将此项目更新转换为Slack格式,以便我将其粘贴到我们的团队频道时看起来很好。”

克劳德使用 convert_markdown 随着 destination: "slack",生成针对Slack渲染优化的输出(粗体、列表、代码块、表情符号支持)。

示例5:检查API使用情况

“这个月我使用了多少个API调用?”

克劳德打电话来 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文档进行了优化
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 商业(专业)
consulting 商业(专业)
startup 商业(专业)

浏览所有62个模板 unmarkdown.com/templates.

API限值

计划 每月API呼叫 费率限制
免费 1000 10要求/秒
专业版(每年8美元/月) 10000 30需求/秒

超龄:每1000次额外通话1.00美元(仅限专业人士)。免费计划有一个硬性限制。

隐私

此MCP服务器将您的降价内容和文档数据发送到Unmarkdown API(api.unmarkdown.com)用于加工。MCP服务器本身不在本地存储任何数据。所有数据处理均受 Unmarkdown隐私政策.

明确地:

  • Markdown内容 通过发送 convert_markdown 被处理并立即返回。它不存储在Unmarkdown服务器上。
  • 文件 通过创建 create_document 或 update_document 存储在您的Unmarkdown帐户中,可以随时删除。
  • API密钥 对请求进行身份验证,并且从不记录或共享。

有关完整的隐私政策,请访问 unmarkdown.com/privacy.

支持

发展

# 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 扩展 --检测并转换任何AI聊天页面(ChatGPT、Claude、Gemini)上的标记
  • 网页应用 --包含62个模板、发布、AI操作和分析的完整编辑器
  • REST API --通过程序访问所有转换和文档功能
  • 铁匠铺 --通过Smithery MCP注册表安装
  • npm — @un-markdown/mcp-server 在npm上

许可证

MIT。看 许可证 了解详情。