MCP 服务器到 Markdown

强大的模型上下文协议 (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 客户端配置

光标集成

导航至光标设置
从侧边栏中选择“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维护

MCP Markdown Conversion Server

Integrations