Cloudflare AI to Markdown

by fradser

34 stars
522 downloads
Not rated
GitHub

About

Bridges Claude with Cloudflare's AI services to convert PDFs, images, HTML, and Office documents into structured markdown descriptions for content analysis and documentation generation.

Details

Author
fradser
Repository
FradSer/mcp-server-to-markdown
GitHub stars
34
Downloads
522
Categories
Cloud Service, Infrastructure, Productivity, Developer Tools, Design, Workplace, File Management, AI, Media, Security, Other

Jump to

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Cloudflare AI to Markdown
    Command (node, npx, python, etc.) mcp-server-to-markdown
    Environment
    • CLOUDFLARE_API_TOKEN your_api_token
    • CLOUDFLARE_ACCOUNT_ID your_account_id

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

1. Clone and setup environment:

git clone <repository-url>

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

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

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

Install globally using npm:

npm install -g mcp-server-to-markdown

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"
          ]
    }
  }
}

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

      

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

to-markdown

Converts various file formats to Markdown descriptions. Input Parameters: filePaths (Array<string>, required) - List of file paths to process.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

Linux

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

Macos

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

Windows

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

MCP Server To Markdown

Twitter Follow
smithery badge

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

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

- 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 claude

Manual Installation

Install globally using npm: 
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:
- filePaths: Array<string> (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

1. Clone and setup environment:

git clone <repository-url>

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

- npm run build - Build TypeScript code
- npm 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

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Install

Add to Claude Desktop or Cursor

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

More like this

Similar MCP servers you might find useful

Browse category

Time

A Model Context Protocol server that provides time and timezone conversion capabilities. It enables LLMs to get current time information and perform timezone…

88.2k
Productivity
SSE

Github SSE

The GitHub MCP Server allows AI tools like GitHub Copilot in VS Code and Visual Studio, Claude Desktop, and others to seamlessly access live GitHub context and…

5.0 15.8k
Developer Tools

AWS MCP Servers

This AWS Labs Model Context Protocol (MCP) server for CloudTrail enables your AI agents to query AWS account activity for security investigations, compliance…

9.4k
Cloud Service