mcp-server-to-markdown

🚀 MCP 服务器到 Markdown 转换器

✨ 这是一个强大的 Model Context Protocol (MCP) 服务器，借助 Cloudflare AI 服务，它能将多种文件格式转换为 Markdown 描述。该服务器提供标准化接口，可实现无缝的文件转换与描述生成。

🚀 快速开始

系统要求

• Node.js 18 或更高版本
• 有效的 Cloudflare API Token
• 激活的 Cloudflare 账户 ID

安装方式

使用 Smithery 安装

通过 Smithery 可自动安装 Markdown 转换服务器：

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

手动安装

全局安装：

npm install -g mcp-server-to-markdown

MCP 客户端配置

在 Cursor 中集成

1. 进入 Cursor 设置
2. 从侧边栏选择 "MCP"
3. 添加以下内容到配置中：

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

在 Claude 中集成

1. 打开 Claude 设置界面
2. 进入插件管理
3. 添加以下配置：

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

启动服务器

克隆仓库

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

启动服务器

node index.js

✨ 主要特性

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

📦 支持的文件格式

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

💻 使用示例

基础用法

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();
}

📚 API 文档

接口

转换文件

• URL: /api/convert
• 方法: POST
• 参数:
  • file: 上传的文件
  • format: 输出格式（markdown 或 plaintext）
• 响应:

{
  "status": "success",
  "data": {
    "content": "转换后的内容"
  }
}

📄 项目维护者

由 Frad LEE 维护

English | 简体中文