Information
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
安装
使用 npm 全局安装：
npm install -g mcp-server-to-markdown
MCP 客户端配置
Cursor 集成
进入 Cursor 设置
从侧边栏选择 "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
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 维护