安裝
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 不要並列當主安裝。