基本能力
产品定位
Convert-Markdown-PDF-MCP 是一个专注于将 Markdown 文档转换为高质量 PDF 的服务,同时提供简单的笔记管理功能。
核心功能
- Markdown 到 PDF 的转换
- 笔记存储系统
- 自定义 note:// URI 方案
- 每个笔记包含名称、描述和纯文本内容
- 笔记摘要生成
- 支持不同详细程度的摘要(brief/detailed)
适用场景
- 开发者需要将技术文档从 Markdown 转换为 PDF
- 个人或团队需要管理技术笔记并生成摘要
- 需要将 Markdown 内容以精美格式分享的场景
工具列表
add-note
工具- 功能:添加新笔记到服务器
- 参数:
name
(必需):笔记名称content
(必需):笔记内容
常见问题解答
- 调试困难:建议使用 MCP Inspector 进行调试
- 发布问题:需要设置 PyPI 凭据才能发布
使用教程
使用依赖
- 确保已安装 Python 环境
- 需要安装 uv 工具(用于运行服务)
安装教程
开发/未发布服务器配置
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 进行浏览器调试