MCP 服务器到 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自动为 Claude Desktop 安装 Markdown 转换服务器:
npx -y @smithery/cli install @FradSer/mcp-server-to-markdown --client claude
手动安装
使用 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维护