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

安装

通过Smithery安装

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

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. 选择“添加新的全局MCP服务器”
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. 选择工具部分
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<string> (必需) - 需要处理的文件路径列表

响应结构：

[
  {
    "filename": "example.pdf",
    "mimeType": "application/pdf",
    "description": "生成的Markdown描述",
    "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/             # 源代码
├── dist/            # 编译输出
├── types.ts         # 类型定义
└── .env             # 环境配置

可用脚本

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

使用示例

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

许可证

MIT许可证

该项目由Frad LEE维护