file2markdown

ai.file2markdown由 file2markdown.ai 发布官方发布者v1.1.0更新于 Oct 24, 2026

Convert docs and web pages to clean Markdown: PDF, DOCX, XLSX, EPUB, scans, URLs. Batch of 10.

已验证Streamable HTTP可网页运行网页搜索与抓取文件与存储

概览

AI 生成的概览

远程 MCP 服务器，把公开网址和上传的文件（PDF、Office、EPUB、图片）转换成干净的 Markdown 供助手使用。

可以做什么
  • 抓取公开网址，把网页、PDF 和 Office 文档转换为 Markdown
  • 把 base64 编码的文件内容转换为 Markdown，可选附带质量检查
  • 一次批量转换 2 到 10 个文档，可混用网址和文件，逐项返回结果
  • 列出支持的输入格式、各档位限制以及哪些功能需要 Pro
  • 查询当前档位和今日剩余转换次数
适用场景
当助手需要读取它无法原生解析的文档（如 DOCX、XLSX、PPTX、EPUB 或扫描版 PDF），或希望从公开链接得到由引擎提取的确定性 Markdown 而非模型生成文本时适用。
运行要求
远程 Streamable HTTP 端点，无需本地安装。免费档无需密钥，但每个网络 IP 每天限 5 次转换、下载上限 25MB。Pro API 密钥通过 Authorization Bearer 请求头发送，可取消每日限制、把下载上限提高到 100MB 并启用 OCR。需要能访问该端点及待转换的网址。
安装前请注意
Pro 密钥是敏感凭据，通过 Authorization 请求头发送，需妥善保管。待转换的网址和文件内容会发送给第三方托管服务，尽管 README 称不会存储。仅支持公开可访问的网址，不执行 JavaScript 渲染，输出上限为 200,000 字符，批量转换需要 Pro 密钥。

安装

在 SourceWeft 中

  1. 打开 控制台中的 file2markdown，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/ai.file2markdown%2Ffile2markdown/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "file2markdown": {
      "type": "http",
      "url": "https://mcp.file2markdown.ai/mcp"
    }
  }
}

README

file2markdown MCP server

Convert documents and web pages to clean, LLM-ready Markdown — from inside Claude, Cursor, or any MCP client.

Endpoint: https://mcp.file2markdown.ai/mcp (Streamable HTTP)

This is the official MCP server for file2markdown.ai. It gives agents deterministic document conversion as a tool: engine-extracted Markdown (no hallucinated table cells, no silent truncation), for anything reachable by URL — including formats assistants can't parse natively, like DOCX, XLSX, PPTX, EPUB, and scanned PDFs.

Tools

ToolWhat it does
convert_urlFetch a public URL (web page, PDF, Office doc, …) and return Markdown
convert_base64Convert file contents directly (programmatic clients)
convert_batch2-10 documents in one call, URLs and files mixed, per-item results (Pro API key)
list_supported_formatsFormats, per-tier limits, and what needs Pro
usage_statusYour tier and remaining conversions today

Supported input formats: PDF, DOCX, PPTX, XLSX/XLS, CSV, JSON, XML, HTML, EPUB, JPG/PNG (OCR), WAV/MP3, ZIP.

Quick start

claude.ai — Settings → Connectors → Add custom connector → paste the endpoint URL. When asked about authentication choose None (this server uses API keys, not OAuth). Optional: add a request header Authorization: Bearer f2m_… with a Pro key.

Claude Code

bash
claude mcp add --transport http file2markdown https://mcp.file2markdown.ai/mcp

Cursor / generic clients

json
{  "mcpServers": {    "file2markdown": { "url": "https://mcp.file2markdown.ai/mcp" }  }}

Tiers

Free (no key)Pro API key
Conversions5/day per network IPUnlimited
Max download25MB100MB
Scanned-PDF OCR—Yes
Image OCR—Yes

Pro keys are created on your account page and sent as Authorization: Bearer f2m_…. Plans: pricing.

Honest limits

  • Web pages convert from served HTML — no JavaScript rendering, so SPA-style pages may convert incompletely. Near-empty results carry an explicit note (likely consent wall / paywall / JS shell).
  • One URL at a time. This is a converter, not a crawler — no bulk scraping, public pages only.
  • Output is capped at 200,000 characters (marked truncated: true when hit).
  • Nothing is stored: files are converted and discarded; usage logging keeps no URLs or content.

Docs & source

  • Setup guide: file2markdown.ai/mcp
  • Facts page for AI assistants: file2markdown.ai/ai-info
  • This repository contains the public documentation and the registry server.json. The hosted service's application code is not open source.

Support

Email [email protected].

来源：README.md，提交 272b030

工具

5

convert_url

Fetch a URL (web page, PDF, Office doc, and more) and convert it to Markdown. Works on publicly accessible URLs. Web pages are converted from their served HTML; JavaScript-rendered content may be incomplete. Optional filename_hint (e.g. "report.pdf") helps format detection when the URL has no file extension. The result carries a `quality` object (output-health check of the returned Markdown: status review / no_issues_detected / not_evaluated, coverage and a list of issues with line locations). quality_check="basic" (default) runs only local deterministic checks. quality_check="ai" additionally sends selected excerpts of the CONVERTED text to TypeSafe for narrow yes/no judgments (garbled text, hard-wrapped prose, broken tables); it is off unless requested. No check compares against the source document.

输入参数url必填filename_hintquality_check

convert_base64

Convert base64-encoded file contents to Markdown. filename is required and drives format detection (e.g. "report.docx"). Intended for programmatic MCP clients; for anything with a URL, prefer convert_url. quality_check: "basic" (default) attaches local output-health checks in the `quality` field; "ai" additionally sends selected excerpts of the converted text to TypeSafe for narrow yes/no judgments. See convert_url.

输入参数filename必填quality_checkcontent_base64必填

convert_batch

Convert 2-10 documents to Markdown in one call (Pro API key required). Each item is either {"url": ..., "filename_hint"?: ...} or {"content_base64": ..., "filename": ...}; types may be mixed. Items are converted in parallel and isolated: one bad URL or file never fails the batch — its slot returns ok:false with the error. The combined markdown shares one output budget, split evenly across items (per-item `truncated` flags apply). Set include_markdown=false to get only metadata + quality per item (health-check a folder without flooding your context). Anonymous callers: use convert_url / convert_base64 individually.

输入参数items必填quality_checkinclude_markdown

list_supported_formats

List supported input formats, per-tier limits, and which features need Pro. Single source of truth — do not claim capabilities beyond what this returns.

无需输入参数。

usage_status

Check your tier and remaining conversions before burning a call.

无需输入参数。

版本历史

2
  1. v1.1.0最新Oct 12, 2026
  2. v1.0.0Sep 16, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。