MCP Server To Markdown is a file conversion service that transforms documents, images, web pages, and spreadsheets into structured Markdown descriptions using Cloudflare AI. Key capabilities: - Converts PDFs, images (JPEG, PNG, WebP, SVG), HTML, XML, CSV, and spreadsheet files (Excel, Numbers, ODS, XLSX, XLS) into Markdown format - Leverages Cloudflare's native tomarkdown API for AI-powered document understanding and content extraction - Extracts readable, structured text from various file types for use in LLM context windows - Supports batch processing of multiple file paths in a single operation

MCP Server To Markdown

[](https://twitter.com/FradSer) [](https://smithery.ai/server/@FradSer/mcp-server-to-markdown)

English | 简体中文

A powerful Model Context Protocol (MCP) server that leverages Cloudflare AI services to convert various file formats into Markdown descriptions. This server provides a standardized interface for seamless file conversion and description generation.

Key Features

Supported File Formats

| Category | File Extensions | |----------|----------------| | Documents | .pdf | | Images | .jpeg, .jpg, .png, .webp, .svg | | Web Content | .html | | Data | .xml, .csv | | Spreadsheets | .xlsx, .xlsm, .xlsb, .xls, .et, .ods, .numbers |

System Requirements

Installation

Installing via Smithery

To install Markdown转换服务器 for Claude Desktop automatically via Smithery:

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

Manual Installation

npm install -g mcp-server-to-markdown

MCP Client Configuration

Cursor Integration

1. Navigate to Cursor settings 2. Select "MCP" from the sidebar 3. Choose "Add new global MCP server" 4. Apply the following configuration:

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

Claude Desktop Setup

Add the following to your 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"
          ]
    }
  }
}

ChatWise Configuration

1. Launch ChatWise 2. Access Settings 3. Select Tools section 4. Click "+" to add new tool 5. Configure with these parameters: - Type: stdio - ID: to-markdown - Command: mcp-server-to-markdown - Args:

      CLOUDFLARE_API_TOKEN=your_api_token
      CLOUDFLARE_ACCOUNT_ID=your_account_id
      

API Reference

to-markdown Tool

Converts various file formats to Markdown descriptions.

Input Parameters:

Response Structure:

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

Development Guide

Getting Started

1. Clone and setup environment:

git clone 
cd mcp-server-to-markdown
cp .env.example .env

2. Configure Cloudflare credentials:

CLOUDFLARE_API_TOKEN=your_api_token
CLOUDFLARE_ACCOUNT_ID=your_account_id

3. Install dependencies and build:

npm install
npm run build

Project Structure

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

Available Scripts

Usage Example

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

License

MIT License

This project is maintained by Frad LEE