MCP Server To Markdown

MCP Server To Markdown

English | 简体中文

一款功能强大的 Model Context Protocol（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 Token
• 有效的 Cloudflare Account ID

安装

通过 Smithery 安装

通过 Smithery 为 Claude Desktop 自动安装 Markdown转换服务器：

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

手动安装

使用 npm 全局安装：

npm install -g mcp-server-to-markdown

MCP 客户端配置

集成 Cursor

1. 前往 Cursor 设置
2. 在侧边栏中选择“MCP”
3. 选择“Add new global MCP server”
4. 应用以下配置：

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

配置 Claude Desktop

将以下内容添加到 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

1. 启动 ChatWise
2. 打开设置
3. 选择 Tools 部分
4. 点击“+”添加新工具
5. 使用以下参数进行配置：
   • 类型：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
  }
]

开发指南

入门

1. 克隆项目并设置环境：

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

2. 配置 Cloudflare 凭据：

CLOUDFLARE_API_TOKEN=your_api_token
CLOUDFLARE_ACCOUNT_ID=your_account_id

3. 安装依赖并构建：

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 inspector 运行

使用示例

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

许可证

MIT 许可证

本项目由 Frad LEE 维护