md-pdf-mcp

Convierte Markdown a PDFs estilizados usando el estilo de markdown de VS Code y ReportLab de Python.

Documentación

md-pdf-mcp (Servidor MCP de Markdown a PDF)

Convierte Markdown a PDF con un estilo elegante utilizando el estilo de Markdown de VS Code y ReportLab de Python.

Componentes

Recursos

El servidor implementa un sistema simple de almacenamiento de notas con:

  • Esquema de URI personalizado note:// para acceder a notas individuales
  • Cada recurso de nota tiene un nombre, descripción y tipo MIME text/plain

Prompts

El servidor proporciona un único prompt:

  • summarize-notes: Crea resúmenes de todas las notas almacenadas
    • Argumento opcional "style" para controlar el nivel de detalle (brief/detailed)
    • Genera un prompt que combina todas las notas actuales con la preferencia de estilo

Herramientas

El servidor implementa una herramienta:

  • add-note: Añade una nueva nota al servidor
    • Requiere "name" y "content" como argumentos de cadena obligatorios
    • Actualiza el estado del servidor y notifica a los clientes sobre cambios en los recursos

Configuración

[TODO: Añadir detalles de configuración específicos de tu implementación]

Inicio rápido

Instalación

Claude Desktop

En MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.jsonEn Windows: %APPDATA%/Claude/claude_desktop_config.json

Configuración de Servidores en Desarrollo/No Publicados \`` "mcpServers": { "md-pdf-mcp": { "command": "uv", "args": \[ "--directory", "/Users/path/to/your/local/md-pdf-mcp", "run", "md-pdf-mcp" \] } } \``\ Configuración de Servidores Publicados \`` "mcpServers": { "md-pdf-mcp": { "command": "uvx", "args": \[ "md-pdf-mcp" \] } } \``\

Desarrollo

Compilación y Publicación

Para preparar el paquete para su distribución:

  1. Sincronizar dependencias y actualizar el archivo de bloqueo:

uv sync

  1. Compilar distribuciones del paquete:

uv build

Esto creará distribuciones de código fuente y wheel en el directorio dist/.

  1. Publicar en PyPI:

uv publish

Nota: Necesitarás configurar las credenciales de PyPI mediante variables de entorno o banderas de comando:

  • Token: --token o UV_PUBLISH_TOKEN
  • O nombre de usuario/contraseña: --username/UV_PUBLISH_USERNAME y --password/UV_PUBLISH_PASSWORD

Depuración

Dado que los servidores MCP se ejecutan sobre stdio, la depuración puede ser desafiante. Para una mejor experiencia de depuración, recomendamos encarecidamente usar el Inspector MCP.

Puedes iniciar el Inspector MCP mediante npm con este comando:

npx @modelcontextprotocol/inspector uv --directory /Users/seanivore/Development/md-pdf-mcp run md-pdf-mcp

Al iniciarse, el Inspector mostrará una URL a la que puedes acceder en tu navegador para comenzar a depurar.