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

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 的转换服务,同时具备笔记管理和总结功能。
核心功能
- Markdown 到 PDF 转换:利用 VS Code 的 Markdown 样式和 Python 的 ReportLab 库生成精美的 PDF 文档。
- 笔记存储系统:支持自定义
note://
URI 方案,用于访问和管理单个笔记。 - 笔记总结功能:提供
summarize-notes
提示,可以生成所有存储笔记的摘要,支持brief
或detailed
两种详细级别。 - 笔记添加工具:通过
add-note
工具添加新笔记,需要提供name
和content
参数。
适用场景
- 文档生成:将 Markdown 格式的技术文档、博客文章等转换为 PDF 格式。
- 笔记管理:存储和管理个人或团队的笔记,并生成摘要以提高效率。
- 开发工具集成:作为开发工具链的一部分,自动化文档生成和笔记管理流程。
工具列表
- add-note:
- 功能:添加新笔记到服务器。
- 参数:
name
(笔记名称,字符串类型,必需)、content
(笔记内容,字符串类型,必需)。 -
效果:更新服务器状态并通知客户端资源变更。
-
summarize-notes:
- 功能:生成所有存储笔记的摘要。
- 参数:
style
(控制摘要详细级别,可选值为brief
或detailed
)。 - 效果:根据当前笔记和样式偏好生成提示。
常见问题解答
- 如何调试 MCP 服务器?
- 由于 MCP 服务器通过 stdio 运行,调试可能较为复杂。推荐使用 MCP Inspector 进行调试。
- 启动命令:
npx @modelcontextprotocol/inspector uv --directory /Users/seanivore/Development/md-pdf-mcp run md-pdf-mcp
。
使用教程
使用依赖
- 确保已安装 Python 和
uv
工具。 - 确保已安装 VS Code 的 Markdown 样式支持。
安装教程
- Claude Desktop 配置:
- MacOS:编辑
~/Library/Application\ Support/Claude/claude_desktop_config.json
。 -
Windows:编辑
%APPDATA%/Claude/claude_desktop_config.json
。 -
开发/未发布服务器配置:
json "mcpServers": { "md-pdf-mcp": { "command": "uv", "args": [ "--directory", "/Users/path/to/your/local/md-pdf-mcp", "run", "md-pdf-mcp" ] } }
-
已发布服务器配置:
json "mcpServers": { "md-pdf-mcp": { "command": "uvx", "args": [ "md-pdf-mcp" ] } }
调试方式
- 使用 MCP Inspector 进行调试:
bash npx @modelcontextprotocol/inspector uv --directory /Users/seanivore/Development/md-pdf-mcp run md-pdf-mcp
- 启动后,访问 Inspector 提供的 URL 进行调试。
许可证
None