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

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

Markdown转PDF的MCP

一个将 Markdown 转换为美观 PDF 的 MCP 服务器,使用 VS Code 的 Markdown 样式和 Python 的 ReportLab。

组件概览

  • 资源: 笔记存储系统,通过 note:// URI 访问
  • 提示: summarize-notes 创建所有笔记的摘要
  • 工具: add-note 添加新笔记到服务器

安装配置

Claude 桌面版

MacOS 配置路径:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows 配置路径:

%APPDATA%/Claude/claude_desktop_config.json

配置示例

开发环境:

"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. 同步依赖项:

    uv sync
    
  2. 构建包:

    uv build
    
  3. 发布到 PyPI:

    uv publish
    

    注意: 需设置 PyPI 凭证,可通过环境变量或命令标志

调试

使用 MCP Inspector 进行调试:

npx @modelcontextprotocol/inspector uv --directory /path/to/md-pdf-mcp run md-pdf-mcp

启动后在浏览器中访问显示的 URL 进行调试。