Servidor MCP a Markdown

Español | 简体中文

Un potente servidor de protocolo de contexto de modelo (MCP) que aprovecha los servicios de IA de Cloudflare para convertir varios formatos de archivo en descripciones Markdown. Este servidor proporciona una interfaz estandarizada para la conversión de archivos y la generación de descripciones sin problemas.

Características principales

• Perfecta integración con los servicios de Cloudflare AI
• Generación eficiente de descripciones Markdown
• Amplia compatibilidad con formatos de archivo
• Integración nativa con la API Tomarkdown de Cloudflare
• Interfaz MCP fácil de usar
• Compatibilidad multiplataforma

Formatos de archivo compatibles

Requisitos del sistema

• Node.js 18 o posterior
• Token de API de Cloudflare válido
• ID de cuenta activa de Cloudflare

Instalación

Instalación a través de Smithery

Para instalar Markdown转换服务器 para Claude Desktop automáticamente a través de Smithery:

npx -y @smithery/cli install @FradSer/mcp-server-to-markdown --client claude

Instalación manual

Instale globalmente usando npm:

npm install -g mcp-server-to-markdown

Configuración del cliente MCP

Integración del cursor

1. Navegue a la configuración de Cursor
2. Seleccione "MCP" en la barra lateral
3. Elija "Añadir nuevo servidor MCP global"
4. Aplique la siguiente configuración:

   { "mcpServers": { "to-markdown": { "command": "mcp-server-to-markdown", "args": [ "CLOUDFLARE_API_TOKEN": "your_api_token" "CLOUDFLARE_ACCOUNT_ID": "your_account_id" ] } }

Configuración de Claude Desktop

Añada lo siguiente a su claude_desktop_config.json:

{ "mcpServers": { "to-markdown": { "command": "mcp-server-to-markdown", "args": [ "CLOUDFLARE_API_TOKEN": "your_api_token" "CLOUDFLARE_ACCOUNT_ID": "your_account_id" ] } }

Configuración de ChatWise

1. Iniciar ChatWise
2. Acceda a Configuración
3. Seleccione la sección Herramientas
4. Haga clic en "+" para añadir una nueva herramienta
5. Configure con estos parámetros
   • Tipo: stdio
   • ID: to-markdown
   • Comando: mcp-server-to-markdown
   • Args:

     CLOUDFLARE_API_TOKEN=tu_api_token CLOUDFLARE_ACCOUNT_ID=tu_id_cuenta

Referencia API

herramienta to-markdown

Convierte varios formatos de archivo a descripciones Markdown.

Parámetros de entrada:

• filePaths: Array (obligatorio) - Lista de rutas de archivos a procesar

Estructura de la respuesta:

[ { "filename": "ejemplo.pdf", "mimeType": "application/pdf", "description": "Descripción Markdown generada", "tokens": 123 } ]

Guía de desarrollo

Primeros pasos

1. Clonar y configurar el entorno:

git clone <repository-url> cd mcp-server-to-markdown cp .env.example .env

2. Configurar las credenciales de Cloudflare:

CLOUDFLARE_API_TOKEN=tu_api_token CLOUDFLARE_ACCOUNT_ID=tu_id_de_cuenta

3. Instalar dependencias y construir:

npm install npm run build

Estructura del proyecto

. ├── src/ # Código fuente ├── dist/ # Salida compilada ├── types.ts # Definiciones de tipos └── .env # Configuración del entorno

Scripts disponibles

• npm run build - Construye el código TypeScript
• npm run inspect - Ejecutar con el inspector MCP

Ejemplo de uso

const result = await toMarkdown({ filePaths: [ "/ruta/a/documento.pdf", "/ruta/a/imagen.jpg" ] })

Licencia

Licencia MIT

Este proyecto es mantenido por Frad LEE