インストール
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 にバインドするが、本機の他プロセスやユーザーからは届く。他の NIC にバインドしない。ツールは convert_to_markdown だけ。ユーザーが読めるファイルとネットワークデータを読める。ゼロリスクではなく、取り消せる書き込みでもない。根拠に undo はない。Docker と pip を並列の主インストールにしない。