关于 file2markdown
file2markdown 是托管的 MCP 服务,可将文档和公开网页转换为 Markdown,供 AI 助手及 MCP 客户端使用。其引擎提取内容,支持客户端可能无法直接解析的格式,包括 Office 文件和扫描版 PDF。
主要功能
- 01将公开 URL 转为 Markdown
- 02转换 Base64 文件内容
- 03批量转换 2–10 份文档
- 04支持 Office、电子书、图像和音频格式
- 05Pro 支持扫描 PDF 与图像 OCR
- 06查询支持格式和用量
适用场景
- 01为 AI 工作流准备 PDF
- 02提取 Office 文档中的表格
- 03将网页转换为 Markdown
- 04在一次请求中处理多份文档
MCP 相关
通过 Streamable HTTP 向 MCP 客户端提供文档转换工具,包括 URL、Base64 和批量转换。托管端点为 https://mcp.file2markdown.ai/mcp。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.file2markdown.ai/mcpclaude mcp add --transport http file2markdown https://mcp.file2markdown.ai/mcp{"mcpServers":{"file2markdown":{"type":"http","url":"https://mcp.file2markdown.ai/mcp"}}}在 Cursor 中打开{"servers":{"file2markdown":{"type":"http","url":"https://mcp.file2markdown.ai/mcp"}}}在 VS Code 中打开{"mcpServers":{"file2markdown":{"type":"http","url":"https://mcp.file2markdown.ai/mcp"}}}{"mcpServers":{"file2markdown":{"serverUrl":"https://mcp.file2markdown.ai/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
https://mcp.file2markdown.ai/mcp需要授权工具
5| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| url | string | 是 | |
| filename_hint | any | 否 | |
| quality_check | string | 否 |
详细介绍
file2markdown MCP 服务
在 Claude、Cursor 或任何 MCP 客户端中,将文档和网页转换为简洁、适合大模型处理的 Markdown。
端点: https://mcp.file2markdown.ai/mcp(Streamable HTTP)
这是 file2markdown.ai 的官方 MCP 服务。它为 Agent 提供确定性的文档转换工具:由引擎提取 Markdown(不会臆造表格单元格,也不会静默截断),可处理任何可通过 URL 访问的内容,包括助手无法原生解析的格式,如 DOCX、XLSX、PPTX、EPUB 和扫描版 PDF。
工具
| 工具 | 功能 |
|---|---|
convert_url | 获取公共 URL(网页、PDF、Office 文档等)并返回 Markdown |
convert_base64 | 直接转换文件内容(适用于程序化客户端) |
convert_batch | 一次调用处理 2-10 份文档,可混合使用 URL 和文件,并返回每项结果(需要 Pro API 密钥) |
list_supported_formats | 查看格式、各套餐限制,以及哪些功能需要 Pro |
usage_status | 查看你的套餐和今天剩余的转换次数 |
支持的输入格式:PDF、DOCX、PPTX、XLSX/XLS、CSV、JSON、XML、HTML、EPUB、JPG/PNG(OCR)、WAV/MP3、ZIP。
快速开始
claude.ai — 设置 → 连接器 → 添加自定义连接器 → 粘贴端点 URL。系统询问身份验证方式时,选择 None(此服务使用 API 密钥,而非 OAuth)。可选:添加请求标头 Authorization: Bearer f2m_… 并附上 Pro 密钥。
Claude Code
claude mcp add --transport http file2markdown https://mcp.file2markdown.ai/mcp
Cursor / 通用客户端
{
"mcpServers": {
"file2markdown": { "url": "https://mcp.file2markdown.ai/mcp" }
}
}
套餐
| 免费(无需密钥) | Pro API 密钥 | |
|---|---|---|
| 转换次数 | 每个网络 IP 每天 5 次 | 不限 |
| 最大下载大小 | 25MB | 100MB |
| 扫描版 PDF OCR | — | 支持 |
| 图片 OCR | — | 支持 |
Pro 密钥可在你的账户页面创建,并通过 Authorization: Bearer f2m_… 发送。套餐价格:定价。
明确的限制
- 网页根据服务器提供的 HTML 转换——不会渲染 JavaScript,因此 SPA 风格的页面可能转换不完整。结果几乎为空时会附带明确说明(可能是遇到了同意授权墙、付费墙或 JS 外壳)。
- 一次处理一个 URL。这是转换器,不是爬虫——不支持批量抓取,且仅处理公共页面。
- 输出上限为 200,000 个字符(达到上限时会标记
truncated: true)。 - 不会存储任何内容:文件转换后即丢弃;使用情况日志不会保留 URL 或内容。
文档与源代码
- 设置指南:file2markdown.ai/mcp
- 面向 AI 助手的事实说明页:file2markdown.ai/ai-info
- 此代码库包含公开文档和注册表
server.json。托管服务的应用代码并非开源。
支持
发送邮件至 [email protected]。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。