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

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

site icon
2025.03.19 6
Python文档转换笔记管理开发效率内容生成
Convert-Markdown-PDF-MCP 是一个将 Markdown 文件转换为精美 PDF 文档的服务。它利用 VS Code 的 Markdown 样式和 Python 的 ReportLab 库来实现高质量的 PDF 生成。该服务还提供了简单的笔记存储系统,支持自定义 URI 方案访问笔记,并能生成笔记摘要。
View on GitHub

Overview

基本能力

产品定位

Convert-Markdown-PDF-MCP 是一个专注于将 Markdown 文档转换为高质量 PDF 的服务,同时提供简单的笔记管理功能。

核心功能

  1. Markdown 到 PDF 的转换
  2. 笔记存储系统
  3. 自定义 note:// URI 方案
  4. 每个笔记包含名称、描述和纯文本内容
  5. 笔记摘要生成
  6. 支持不同详细程度的摘要(brief/detailed)

适用场景

  1. 开发者需要将技术文档从 Markdown 转换为 PDF
  2. 个人或团队需要管理技术笔记并生成摘要
  3. 需要将 Markdown 内容以精美格式分享的场景

工具列表

  1. add-note 工具
  2. 功能:添加新笔记到服务器
  3. 参数:
    • name(必需):笔记名称
    • content(必需):笔记内容

常见问题解答

  1. 调试困难:建议使用 MCP Inspector 进行调试
  2. 发布问题:需要设置 PyPI 凭据才能发布

使用教程

使用依赖

  1. 确保已安装 Python 环境
  2. 需要安装 uv 工具(用于运行服务)

安装教程

开发/未发布服务器配置

"mcpServers": {
  "md-pdf-mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "/Users/path/to/your/local/md-pdf-mcp",
      "run",
      "md-pdf-mcp"
    ]
  }
}

已发布服务器配置

"mcpServers": {
  "md-pdf-mcp": {
    "command": "uvx",
    "args": [
      "md-pdf-mcp"
    ]
  }
}

调试方式

  1. 使用 MCP Inspector 进行调试
npx @modelcontextprotocol/inspector uv --directory /Users/seanivore/Development/md-pdf-mcp run md-pdf-mcp
  1. 访问 Inspector 提供的 URL 进行浏览器调试

许可证

该项目遵循 None 开源许可条款。