MCP Markdown Conversion Server
The MCP Markdown Conversion Server converts various file formats into Markdown descriptions using Cloudflare AI services.
File Conversion: Supports documents (.pdf), images (.jpeg, .jpg, .png, .webp, .svg), web content (.html), data (.xml, .csv), and spreadsheets (Microsoft Office formats, Open Document Format, Apple Documents).
Integration: Seamlessly works with MCP clients like Cursor, Claude Desktop, and ChatWise.
API Access: Accepts an array of file paths as input and returns structured information including filename, MIME type, Markdown description, and token count.
Development Support: Includes configuration options and detailed guides.
Utilizes Cloudflare AI services, specifically the tomarkdown API, to convert various file types to Markdown descriptions
Uses dotenv for environment configuration to store Cloudflare authentication credentials
Converts various file formats (including PDF, images, Office documents, and more) into Markdown descriptions
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Markdown Conversion Server convert my presentation.pdf to markdown"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
Seamless integration with Cloudflare AI services
Efficient Markdown description generation
Comprehensive file format support
Native Cloudflare tomarkdown API integration
User-friendly MCP interface
Cross-platform compatibility
Related MCP server: Textin MCP Server
Supported File Formats
Category | File Extensions |
Documents | |
Images | .jpeg, .jpg, .png, .webp, .svg |
Web Content | .html |
Data | .xml, .csv |
Spreadsheets | .xlsx, .xlsm, .xlsb, .xls, .et, .ods, .numbers |
System Requirements
Node.js 18 or later
Valid Cloudflare API Token
Active Cloudflare Account ID
Installation
Installing via Smithery
To install Markdown转换服务器 for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @FradSer/mcp-server-to-markdown --client claudeManual Installation
Install globally using npm:
npm install -g mcp-server-to-markdownMCP Client Configuration
Cursor Integration
Navigate to Cursor settings
Select "MCP" from the sidebar
Choose "Add new global MCP server"
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
Launch ChatWise
Access Settings
Select Tools section
Click "+" to add new tool
Configure with these parameters:
Type:
stdioID:
to-markdownCommand:
mcp-server-to-markdownArgs:
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:
filePaths: Array (required) - List of file paths to process
Response Structure:
[
{
"filename": "example.pdf",
"mimeType": "application/pdf",
"description": "Generated Markdown description",
"tokens": 123
}
]Development Guide
Getting Started
Clone and setup environment:
git clone <repository-url>
cd mcp-server-to-markdown
cp .env.example .envConfigure Cloudflare credentials:
CLOUDFLARE_API_TOKEN=your_api_token
CLOUDFLARE_ACCOUNT_ID=your_account_idInstall dependencies and build:
npm install
npm run buildProject Structure
.
├── src/ # Source code
├── dist/ # Compiled output
├── types.ts # Type definitions
└── .env # Environment configurationAvailable Scripts
npm run build- Build TypeScript codenpm run inspect- Run with MCP inspector
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
Available Tools
1 toolto-markdownC
Generate markdown description for files including PDF (.pdf), Images (.jpeg, .jpg, .png, .webp, .svg), HTML (.html), XML (.xml), Microsoft Office (.xlsx, .xlsm, .xlsb, .xls, .et), Open Document Format (.ods), CSV (.csv), and Apple Documents (.numbers)
Inputs: filePaths (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of confusion or overlap between tools. The single tool 'to-markdown' has a clearly defined and distinct purpose: converting various file formats to markdown descriptions.
Since there is only one tool, naming consistency is inherently perfect. The tool name 'to-markdown' follows a clear verb-object pattern that is appropriate for its function.
A single tool is too few for a server with a broad scope like 'Markdown Conversion Server' that handles multiple file types. This thin surface may force agents to rely on this one tool for all conversion tasks, lacking specialized operations for different formats or scenarios.
The tool set is severely incomplete for the server's purpose. While 'to-markdown' covers conversion, there are obvious gaps such as no tools for validating markdown, handling conversion errors, or providing metadata about supported formats, which limits agent workflows.
Related MCP Connectors
Document-to-Markdown MCP server — convert PDF, Office and HTML into LLM-ready Markdown.
Document conversion MCP server: PDF to Markdown, image OCR, spreadsheet parsing.
Convert PDF, DOCX, XLSX and 25 other formats to clean Markdown for LLMs and RAG. No key or account.
Document to Markdown MCP server: PDF, Word, PowerPoint, Excel and HTML, with OCR for large files.
Related MCP Servers
- AlicenseAqualityDmaintenanceA document conversion server that transforms various file formats (PDFs, documents, images, audio, web content) to Markdown with improved multilingual and UTF-8 support.1015MIT

Textin MCP Serverofficial
AlicenseCqualityDmaintenanceA server that enables OCR capabilities to recognize text from images, PDFs, and Word documents, convert them to Markdown, and extract key information.329MIT- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that converts various file formats (PDF, PowerPoint, Word, Excel, Images, etc.) to Markdown to make them accessible to LLMs.1MIT
- AlicenseNot gradedqualityCmaintenanceMCP server for converting various file formats (PDF, DOCX, images, audio, etc.) to Markdown using Microsoft MarkItDown, with support for large files and Cyrillic text.25 PyPI1MIT