文件转Markdown服务

一个利用Cloudflare AI服务将各种文件格式转换为Markdown描述的MCP服务器,提供标准化的文件转换和描述生成接口。

  • by FradSer
  • JavaScript
  • 本地部署
  • 35 星标
  • 更新于
在 GitHub 查看 FradSer/mcp-server-to-markdown

使用说明

MCP服务器到Markdown

英语| 简体中文

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

主要特点

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

支持的文件格式

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

系统要求

  • Node.js 18或更高版本
  • 有效的Cloudflare API代币
  • 活动Cloudflare帐户ID

安装

通过Smithery安装

安装Markdown转换服务器 克劳德桌面自动通过 史密瑟里:

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

手动安装

使用npm全局安装:

npm install -g mcp-server-to-markdown

MCP客户端配置

光标集成

  1. 导航到光标设置
  2. 从侧边栏中选择“MCP”
  3. 选择“添加新的全局MCP服务器”
  4. 应用以下配置:
    {
      "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配置

  1. 启动ChatWise
  2. 访问设置
  3. 选择工具部分
  4. 点击“+”添加新工具
  5. 使用这些参数进行配置:
    • 类型: stdio
    • 身份证件: to-markdown
    • 命令: mcp-server-to-markdown
    • Args:
      CLOUDFLARE_API_TOKEN=your_api_token
      CLOUDFLARE_ACCOUNT_ID=your_account_id
      

api参考

到标记工具

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

输入参数:

  • filePaths:数组 (必填)-要处理的文件路径列表

响应结构:

[
  {
    "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
  1. 配置Cloudflare凭据:
CLOUDFLARE_API_TOKEN=your_api_token
CLOUDFLARE_ACCOUNT_ID=your_account_id
  1. 安装依赖项并构建:
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许可证

该项目由以下人员维护 李