安装
pip install markitdown-mcp适合谁
适合要在本机把一份文档或网页转成 Markdown、并交给受信任代理使用的人。证据写明：markitdown-mcp 提供轻量 STDIO、Streamable HTTP 和 SSE 服务器，只暴露一个工具 convert_to_markdown(uri)，uri 可以是 http:、https:、file: 或 data:。
它按设计给本地、受信任的代理用。没有鉴权，进程权限等于启动它的用户。convert_to_markdown 能读该用户能读的任何文件，也能取网络数据。不要在共享机器上对不信任的客户端开放。
证据没有列出客户端名单。不要把 HTTP/SSE 绑到非 localhost，除非你清楚风险。
3 分钟完成第一次尝试
走 pip 主路径，不要把 Docker 当主安装：
pip install markitdown-mcp
markitdown-mcp
默认 STDIO。需要 HTTP/SSE 时证据给出：
markitdown-mcp --http --host 127.0.0.1 --port 3001
第一次用 STDIO，保持绑定在本机。
前置条件：本机 Python/pip 可用；第一次只转换你有权公开访问的 https: 页面，不要先喂密钥文件或内网 file:。这会读你指定的 URI，并可能出网。
配置位置：客户端 MCP 把 command 设为 markitdown-mcp（stdio）。HTTP 仅在你理解「本机任何进程都可访问」之后再开。
低风险第一次调用：convert_to_markdown(uri)，uri 用一条公开 https:。不要用 file: 指向家目录或密钥，不要改 --host。
成功信号：工具返回该 URI 转换后的 Markdown。若进程起不来，先核 pip 包名，不要改走 Docker。
使用案例
案例 1：把一篇公开网页转成 Markdown。调用 convert_to_markdown，uri 为 https:。证据只保证接受这类 URI，没有写输出样式、大小上限或对登录墙的处理。因此能确认的是：你看到转换文本为止。
案例 2：把本地文件转成 Markdown。uri 用 file:。这会以服务器用户权限读盘，本机其他进程在 HTTP/SSE 模式下也能触发同样读取。先确认路径不含密钥。data: URI 同样会进入转换，证据没有写长度限制。Docker 构建是 docker build -t markitdown-mcp:latest . 再 docker run -it --rm markitdown-mcp:latest，与 pip 不是同一条主路径。
使用边界
无鉴权，权限等于启动用户。HTTP/SSE 默认绑 localhost，仍可被本机其他进程或用户访问。不要绑到其他网卡。工具只有 convert_to_markdown。它能读用户能读的文件和网络数据，不是零风险、也不是可撤销的写操作——证据没有 undo。Docker 与 pip 不要并列当主安装。