markitdown-mcp · MarkItDown 繁中教學站

重要：markitdown-mcp 設計給本機、受信任的 agent使用。以 Streamable HTTP / SSE 啟動時預設只綁 localhost，不對外網曝露——請勿自行綁到其他介面，除非你了解安全後果。

安裝與啟動

pip install markitdown-mcp

# STDIO（預設，最適合 MCP client）
markitdown-mcp

# Streamable HTTP（綁本機）
markitdown-mcp --http --host 127.0.0.1 --port 3001

單一工具：convert_to_markdown(uri)

參數 uri 可以是任何 http:、https:、file:、data: URI——與核心的 convert_uri() 一致。

Docker 啟動

docker build -t markitdown-mcp:latest .
docker run -it --rm markitdown-mcp:latest

# 存取本機檔案：掛載目錄
docker run -it --rm -v /home/user/data:/workdir markitdown-mcp:latest

接上 Claude Desktop

// claude_desktop_config.json
{
  "mcpServers": {
    "markitdown": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "markitdown-mcp:latest"]
    }
  }
}

要讀本機目錄就加掛載："args": ["run", "--rm", "-i", "-v", "/home/user/data:/workdir", "markitdown-mcp:latest"]。

Debug 用 MCP Inspector

npx @modelcontextprotocol/inspector

STDIO：transport 選 STDIO，command 填 markitdown-mcp → Connect。
Streamable HTTP：URL 填 http://127.0.0.1:3001/mcp → Connect。
SSE：URL 填 http://127.0.0.1:3001/sse → Connect。
Tools 頁籤 → List Tools → 對任意有效 URI 執行 convert_to_markdown。

安全考量

伺服器不支援認證，以執行者的權限運作。
HTTP/SSE 預設綁 localhost，但同機任何程序/使用者仍可呼叫。
convert_to_markdown 能讀伺服器使用者可讀的任何檔案、以及任何網路上的資料。
需要更高安全時：放進 VM / 容器沙箱，限制使用者權限；絕對不要綁到非 localhost 介面。