md-pdf-mcp (Markdown to PDF MCP Server)

md-pdf-mcp (Markdown to PDF MCP Server)

site icon
2025.03.19 7
Python文档转换笔记管理内容生成开发效率
Convert-Markdown-PDF-MCP 是一个将 Markdown 文件转换为精美 PDF 文档的服务,利用 VS Code 的 Markdown 样式和 Python 的 ReportLab 库来实现高质量的文档转换。该服务不仅支持基本的 Markdown 到 PDF 的转换,还提供了一个简单的笔记存储系统,可以管理和总结笔记内容。
View on GitHub

Overview

基本能力

产品定位

Convert-Markdown-PDF-MCP 是一个专为开发者和内容创作者设计的工具,旨在提供高质量的 Markdown 到 PDF 的转换服务,同时具备笔记管理和总结功能。

核心功能

  1. Markdown 到 PDF 转换:利用 VS Code 的 Markdown 样式和 Python 的 ReportLab 库生成精美的 PDF 文档。
  2. 笔记存储系统:支持自定义 note:// URI 方案,用于访问和管理单个笔记。
  3. 笔记总结功能:提供 summarize-notes 提示,可以生成所有存储笔记的摘要,支持 briefdetailed 两种详细级别。
  4. 笔记添加工具:通过 add-note 工具添加新笔记,需要提供 namecontent 参数。

适用场景

  1. 文档生成:将 Markdown 格式的技术文档、博客文章等转换为 PDF 格式。
  2. 笔记管理:存储和管理个人或团队的笔记,并生成摘要以提高效率。
  3. 开发工具集成:作为开发工具链的一部分,自动化文档生成和笔记管理流程。

工具列表

  1. add-note
  2. 功能:添加新笔记到服务器。
  3. 参数:name(笔记名称,字符串类型,必需)、content(笔记内容,字符串类型,必需)。
  4. 效果:更新服务器状态并通知客户端资源变更。

  5. summarize-notes

  6. 功能:生成所有存储笔记的摘要。
  7. 参数:style(控制摘要详细级别,可选值为 briefdetailed)。
  8. 效果:根据当前笔记和样式偏好生成提示。

常见问题解答

  1. 如何调试 MCP 服务器?
  2. 由于 MCP 服务器通过 stdio 运行,调试可能较为复杂。推荐使用 MCP Inspector 进行调试。
  3. 启动命令:npx @modelcontextprotocol/inspector uv --directory /Users/seanivore/Development/md-pdf-mcp run md-pdf-mcp

使用教程

使用依赖

  1. 确保已安装 Python 和 uv 工具。
  2. 确保已安装 VS Code 的 Markdown 样式支持。

安装教程

  1. Claude Desktop 配置
  2. MacOS:编辑 ~/Library/Application\ Support/Claude/claude_desktop_config.json
  3. Windows:编辑 %APPDATA%/Claude/claude_desktop_config.json

  4. 开发/未发布服务器配置json "mcpServers": { "md-pdf-mcp": { "command": "uv", "args": [ "--directory", "/Users/path/to/your/local/md-pdf-mcp", "run", "md-pdf-mcp" ] } }

  5. 已发布服务器配置json "mcpServers": { "md-pdf-mcp": { "command": "uvx", "args": [ "md-pdf-mcp" ] } }

调试方式

  1. 使用 MCP Inspector 进行调试: bash npx @modelcontextprotocol/inspector uv --directory /Users/seanivore/Development/md-pdf-mcp run md-pdf-mcp
  2. 启动后,访问 Inspector 提供的 URL 进行调试。

许可证

None