MCP Server To Markdown

Convierte varios formatos de archivo a Markdown usando Cloudflare AI.

Documentación

MCP Server To Markdown

Un potente servidor de Model Context Protocol (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 inconvenientes.

Características principales

Integración perfecta con los servicios de IA de Cloudflare
Generación eficiente de descripciones Markdown
Soporte integral de formatos de archivo
Integración nativa con la API tomarkdown de Cloudflare
Interfaz MCP fácil de usar
Compatibilidad multiplataforma

Formatos de archivo compatibles

Categoría	Extensiones de archivo
Documentos	.pdf
Imágenes	.jpeg, .jpg, .png, .webp, .svg
Contenido web	.html
Datos	.xml, .csv
Hojas de cálculo	.xlsx, .xlsm, .xlsb, .xls, .et, .ods, .numbers

Requisitos del sistema

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

Instalación

Instalación mediante Smithery

Para instalar Markdown转换服务器 para Claude Desktop automáticamente mediante 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 con Cursor

Navegue a la configuración de Cursor
Seleccione "MCP" en la barra lateral
Elija "Add new global MCP server"

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

Agregue 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

Inicie ChatWise
Acceda a Configuración
Seleccione la sección Herramientas
Haga clic en "+" para agregar una nueva herramienta
Configure con estos parámetros:
- Tipo: stdio
- ID: to-markdown
- Comando: mcp-server-to-markdown
- Argumentos:
```
CLOUDFLARE_API_TOKEN=your_api_token
CLOUDFLARE_ACCOUNT_ID=your_account_id
```

Referencia de la API

Herramienta to-markdown

Convierte varios formatos de archivo en descripciones Markdown.

Parámetros de entrada:

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

Estructura de respuesta:

[
  {
    "filename": "example.pdf",
    "mimeType": "application/pdf",
    "description": "Generated Markdown description",
    "tokens": 123
  }
]

Guía de desarrollo

Primeros pasos

Clone y configure el entorno:

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

Configure las credenciales de Cloudflare:

CLOUDFLARE_API_TOKEN=your_api_token
CLOUDFLARE_ACCOUNT_ID=your_account_id

Instale las dependencias y compile:

npm install
npm run build

Estructura del proyecto

.
├── src/             # Source code
├── dist/            # Compiled output
├── types.ts         # Type definitions
└── .env             # Environment configuration

Scripts disponibles

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

Ejemplo de uso

const result = await toMarkdown({
  filePaths: [
    "/path/to/document.pdf",
    "/path/to/image.jpg"
  ]
});

Licencia

Licencia MIT

Este proyecto es mantenido por Frad LEE