md-pdf-mcp — конвертация Markdown в PDF через MCP

Сервер md-pdf-mcp (Markdown to PDF MCP Server) преобразует Markdown-файлы в стилизованные PDF-документы, используя оформление VS Code для Markdown и Python-библиотеку ReportLab. Реализован по протоколу MCP (Model Context Protocol) и может быть подключён к любому MCP-клиенту (Claude Desktop, IDE и т.п.).

Компоненты

Ресурсы

Сервер реализует простую систему хранения заметок с собственным URI-схемой note://. Каждый ресурс заметки содержит имя, описание и MIME-тип text/plain.

Промпты

Единственный промпт — summarize-notes: создаёт краткое содержание всех сохранённых заметок. Принимает необязательный аргумент style для контроля уровня детализации (brief или detailed).

Инструменты

Один инструмент — add-note: добавляет новую заметку на сервер. Требует два обязательных строковых аргумента: name (название) и content (содержимое). После добавления обновляет состояние сервера и уведомляет клиентов об изменении ресурсов.

Конфигурация

[TODO: добавьте параметры, специфичные для вашей реализации, если требуется]

Быстрый старт

Установка

Убедитесь, что у вас установлены Python 3.10+ и пакетный менеджер uv (рекомендуется) или стандартный pip.

Claude Desktop

Добавьте сервер в конфигурацию Claude Desktop. Пути к файлу конфигурации:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

Для локальной (неопубликованной) версии:

{
  "mcpServers": {
    "md-pdf-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/путь/к/локальной/папке/md-pdf-mcp",
        "run",
        "md-pdf-mcp"
      ]
    }
  }
}

Для опубликованной версии (из PyPI):

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

После изменения конфигурации перезапустите Claude Desktop.

Разработка и публикация

Сборка и публикация

1. Синхронизируйте зависимости и обновите lock-файл:

   uv sync
   

2. Соберите дистрибутив:

   uv build
   

   Будут созданы source- и wheel-архивы в папке dist/.
3. Опубликуйте на PyPI:

   uv publish
   

   Учётные данные PyPI можно передать через переменные окружения или аргументы командной строки:
   • --token или UV_PUBLISH_TOKEN (токен),
   • --username / UV_PUBLISH_USERNAME и --password / UV_PUBLISH_PASSWORD (логин/пароль).

Отладка

Поскольку MCP-серверы работают через stdio, отладка может быть непростой. Рекомендуется использовать MCP Inspector (репозиторий).

Запустите Inspector через npm:

npx @modelcontextprotocol/inspector uv --directory /путь/к/md-pdf-mcp run md-pdf-mcp

После запуска Inspector покажет URL, который можно открыть в браузере для отладки.

Сервер распространяется под лицензией MIT (см. файл LICENSE).