mcp-pandoc: un servidor MCP de conversión de documentos

Incluido oficialmente en el proyecto de código abierto de servidores de Protocolo de Contexto de Modelo . 🎉

Descripción general

Un servidor de Protocolo de Contexto de Modelo para la conversión de formatos de documentos mediante pandoc . Este servidor proporciona herramientas para transformar contenido entre diferentes formatos de documentos, conservando el formato y la estructura.

Tenga en cuenta que mcp-pandoc se encuentra actualmente en desarrollo inicial. La compatibilidad con PDF también está en desarrollo, y la funcionalidad y las herramientas disponibles están sujetas a cambios y ampliaciones a medida que mejoramos el servidor.

Crédito: Este proyecto utiliza el paquete Python Pandoc para la conversión de documentos, lo que constituye la base de este proyecto.

Manifestación

🎥 Míralo en YouTube

Más por venir...

Herramientas

1. convert-contents
   • Transforma el contenido entre formatos compatibles
   • Entradas:
     • contents (cadena): contenido de origen a convertir (obligatorio si no se proporciona input_file)
     • input_file (cadena): ruta completa al archivo de entrada (obligatorio si no se proporciona el contenido)
     • input_format (cadena): formato de origen del contenido (predeterminado en Markdown)
     • output_format (cadena): formato de destino (predeterminado en Markdown)
     • output_file (cadena): ruta completa para el archivo de salida (obligatorio para los formatos pdf, docx, rst, latex, epub)
   • Formatos de entrada/salida admitidos:
     • reducción
     • html
     • pdf
     • docx
     • primero
     • látex
     • libro electrónico
     • TXT
   • Nota: Para formatos avanzados (pdf, docx, rst, latex, epub), se requiere una ruta de archivo de salida

Formatos compatibles

Formatos admitidos actualmente:

Formatos básicos (conversión directa):

• Texto sin formato (.txt)
• Markdown (.md)
• HTML (.html)

Formatos avanzados (requiere rutas de archivo completas):

• PDF (.pdf) - requiere instalación de TeX Live
• DOCX (.docx)
• RST (.rst)
• LaTeX (.tex)
• EPUB (.epub)

Nota: Para formatos avanzados:

1. Se requieren rutas de archivo completas con nombre de archivo y extensión
2. La conversión de PDF requiere la instalación de TeX Live (consulte la sección Requisitos críticos -> Para macOS: brew install texlive )
3. Cuando no se especifica ninguna ruta de salida:
   • Formatos básicos: Muestra el contenido convertido en el chat.
   • Formatos avanzados: Se puede guardar en el directorio temporal del sistema (/tmp/ en sistemas Unix)

Uso y configuración

Para utilizar el publicado

⚠️ Notas importantes

Requisitos críticos

1. Requisitos previos para la conversión de PDF
   • TeX Live debe estar instalado antes de intentar la conversión a PDF
   • Comandos de instalación:
     # Ubuntu/Debian sudo apt-get install texlive-xetex # macOS brew install texlive # Windows # Install MiKTeX or TeX Live from: # https://miktex.org/ or https://tug.org/texlive/
2. Requisitos de ruta de archivo
   • Al guardar o convertir archivos, DEBE proporcionar las rutas de archivo completas, incluido el nombre del archivo y la extensión.
   • La herramienta no genera automáticamente nombres de archivos ni extensiones.

Ejemplos

✅ Uso correcto:

❌ Uso incorrecto:

Problemas comunes y soluciones

1. La conversión de PDF falla
   • Error: "xelatex no encontrado"
   • Solución: Instale primero TeX Live (consulte los comandos de instalación anteriores)
2. La conversión de archivos falla
   • Error: "Ruta de archivo no válida"
   • Solución: proporcione la ruta completa, incluido el nombre del archivo y la extensión
   • Ejemplo: /path/to/document.pdf en lugar de simplemente /path/to/
3. La conversión de formato falla
   • Error: "Formato no compatible"
   • Solución: utilice únicamente formatos compatibles:
     • Básico: txt, html, markdown
     • Avanzado: pdf, docx, rst, latex, epub

Inicio rápido

Instalar

Opción 1: Instalación manual mediante el archivo de configuración claude_desktop_config.json

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

ℹ️ Reemplace con la ruta de su proyecto clonado localmente

Opción 2: Instalar automáticamente la configuración de servidores publicados a través de Smithery

Ejecute el siguiente comando bash para instalar automáticamente mcp-pandoc pypi publicado para Claude Desktop a través de Smithery :

Nota : Para utilizar mcp-pandoc configurado localmente, siga el paso "Configuración de servidores no publicados/desarrollo" anterior.

Desarrollo

Construcción y publicación

Para preparar el paquete para su distribución:

1. Sincronizar dependencias y actualizar archivo de bloqueo:

2. Distribuciones de paquetes de compilación:

Esto creará distribuciones de origen y de rueda en el directorio dist/ .

3. Publicar en PyPI:

Nota: Deberás configurar las credenciales de PyPI a través de variables de entorno o indicadores 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 en stdio, la depuración puede ser complicada. Para una experiencia óptima, recomendamos usar el Inspector MCP .

Puede iniciar el Inspector MCP a través de npm con este comando:

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

Contribuyendo

Agradecemos sus contribuciones para mejorar mcp-pandoc. Así es como puede participar:

1. Reportar problemas : ¿Encontraste un error o tienes alguna solicitud de funcionalidad? Abre un problema en nuestra página de problemas de GitHub .
2. Enviar solicitudes de extracción : mejore la base de código o agregue funciones mediante la creación de una solicitud de extracción.