MCP Server To Markdown

🚀 MCP Server to Markdown Converter

English | Simplified Chinese

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.

🚀 Quick Start

This MCP server is designed to efficiently convert multiple file formats into Markdown descriptions using Cloudflare AI services. With a standardized interface, it enables smooth file conversion and description generation.

✨ Features

• Seamless integration with Cloudflare AI services
• Efficient Markdown description generation
• Support for multiple file formats
• Integration of the native Cloudflare toMarkdown API
• User-friendly MCP interface
• Cross-platform compatibility

📦 Supported File Formats

📋 System Requirements

• Node.js 18 or higher
• A valid Cloudflare API Token
• An activated Cloudflare account ID

📦 Installation

Install via Smithery

Automatically install the Markdown conversion server through Smithery:

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

Manual Installation

Install globally:

npm install -g mcp-server-to-markdown

💻 MCP Client Configuration

Integration in Cursor

1. Go to Cursor settings.
2. Select "MCP" from the sidebar.
3. Add the following content to the configuration:

"mcp-server-to-markdown": {
  "serverUrl": "YOUR_SERVER_URL",
  "apiKey": "YOUR_API_KEY"
}

Integration in Claude

1. Open the Claude settings interface.
2. Navigate to plugin management.
3. Add the following configuration:

{
  "mcp-server-to-markdown": {
    "enabled": true,
    "serverUrl": "YOUR_SERVER_URL",
    "apiKey": "YOUR_API_KEY"
  }
}

📚 API Documentation

API Endpoints

Convert a File

• URL: /api/convert
• Method: POST
• Parameters:
  • file: The uploaded file
  • format: The output format (markdown or plaintext)
• Response:

  {
    "status": "success",
    "data": {
      "content": "The converted content"
    }
  }
  

💻 Usage Examples

Basic Usage

const fetch = require('node-fetch');

async function convertFile(filePath, format) {
  const formData = new FormData();
  formData.append('file', fs.createReadStream(filePath));
  formData.append('format', format);

  const response = await fetch('/api/convert', {
    method: 'POST',
    body: formData
  });

  return await response.json();
}

🛠️ Development Guide

Clone the Repository

git clone https://github.com/FradSer/mcp-server-to-markdown.git
cd mcp-server-to-markdown
npm install

Start the Server

node index.js

🧑‍💻 Project Maintainer

Maintained by Frad LEE