Cloudflare AI Markdown转换服务器

@FradSer/mcp-server-to-markdown

0 Stars 517 次浏览 Frad 更新于 2026-08-23

一种使用Cloudflare AI服务将各种文件格式（PDF、图像、Office文档等）转换为Markdown描述的服务器。

娱乐与多媒体文件系统

该服务暂未提供标准配置，请参考 README 手动接入

服务介绍

MCP Server To Markdown

English | 简体中文

一个强大的模型上下文协议（MCP）服务器，利用 Cloudflare AI 服务将各种文件格式转换为 Markdown 描述。该服务器提供了一个标准化的接口，用于无缝文件转换和描述生成。

主要功能

与 Cloudflare AI 服务无缝集成
高效的 Markdown 描述生成
全面支持多种文件格式
原生 Cloudflare tomarkdown API 集成
用户友好的 MCP 接口
跨平台兼容性

支持的文件格式

类别	文件扩展名
文档	.pdf
图像	.jpeg, .jpg, .png, .webp, .svg
网页内容	.html
数据	.xml, .csv
电子表格	.xlsx, .xlsm, .xlsb, .xls, .et, .ods, .numbers

系统要求

Node.js 18 或更高版本
有效的 Cloudflare API 令牌
活跃的 Cloudflare 账户 ID

安装

使用 npm 全局安装：

npm install -g mcp-server-to-markdown

MCP 客户端配置

Cursor 集成

进入 Cursor 设置
从侧边栏选择 "MCP"
选择 "添加新的全局 MCP 服务器"

应用以下配置：

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

Claude 桌面设置

在你的 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 配置

启动 ChatWise
访问设置
选择工具部分
点击 "+" 添加新工具
使用这些参数进行配置：
- 类型: stdio
- ID: to-markdown
- 命令: mcp-server-to-markdown
- 参数:
```
CLOUDFLARE_API_TOKEN=your_api_token
CLOUDFLARE_ACCOUNT_ID=your_account_id
```

API 参考

to-markdown 工具

将各种文件格式转换为 Markdown 描述。

输入参数：

filePaths: Array (必需) - 要处理的文件路径列表

响应结构：

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

开发指南

入门

克隆并设置环境：

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

配置 Cloudflare 凭证：

CLOUDFLARE_API_TOKEN=your_api_token
CLOUDFLARE_ACCOUNT_ID=your_account_id

安装依赖并构建：

npm install
npm run build

项目结构

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

可用脚本

npm run build - 构建 TypeScript 代码
npm run inspect - 使用 MCP 检查器运行

使用示例

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

许可证

MIT 许可证

该项目由 Frad LEE 维护

查看源码项目主页