AgentMD

agentmd-mcp

AgentMD 用の MCP サーバーです。PDF、DOCX、HTML、URL を、表を保持しウェブページの定型的な要素を除去した、LLM が扱いやすいクリーンな Markdown に変換します。

エージェントは常にドキュメントを取り込みますが、多くのドキュメント形式は言語モデルにとって扱いにくいものです。この MCP サーバーは、あらゆる形式のドキュメントをエージェントが実際に読み取れる Markdown に変換する 3 つのツールを提供します。

インストール

https://www.getagentmd.com で無料の API キーを取得できます（50 回まで変換可能、クレジットカード不要）。または、すべてをプログラムから実行できます。

curl -X POST https://www.getagentmd.com/api/v1/keys/free \
  -H "Content-Type: application/json" -d '{"email": "[email protected]"}'

続いて、次のようにします。

Claude Code

claude mcp add agentmd --env AGENTMD_API_KEY=<your-key> -- npx -y agentmd-mcp

任意の MCP クライアント（mcp.json / claude_desktop_config.json）：

{
  "mcpServers": {
    "agentmd": {
      "command": "npx",
      "args": ["-y", "agentmd-mcp"],
      "env": { "AGENTMD_API_KEY": "<your-key>" }
    }
  }
}

Docker

docker build -t agentmd-mcp .
docker run -i --rm -e AGENTMD_API_KEY=<your-key> agentmd-mcp

イメージは stdio サーバーを実行するため、-i を渡してください。API キーはイメージに埋め込まず、実行時に -e で指定します。コンテナを MCP クライアントに接続するには、次のようにします。

{
  "mcpServers": {
    "agentmd": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "AGENTMD_API_KEY", "agentmd-mcp"],
      "env": { "AGENTMD_API_KEY": "<your-key>" }
    }
  }
}

リモート（インストール不要） — ホストされたサーバーは、ストリーム可能な HTTP を直接使用します。

claude mcp add --transport http agentmd https://www.getagentmd.com/api/mcp \
  --header "Authorization: Bearer <your-key>"

ツール

ツール	用途
convert_url_to_markdown	ウェブページ、または http(s) URL 上のドキュメント
convert_file_to_markdown	ローカルファイルシステム上のドキュメント（パスを指定）
convert_document_to_markdown	base64 形式で保持しているドキュメントのバイトデータ

3 つのツールはいずれも、検出されたタイトルと警告を先頭に付けて Markdown を返します。

対応フォーマット

• PDF — テキスト抽出（スキャンされた PDF や画像のみの PDF では警告が返されます。OCR は今後対応予定です）
• DOCX — 見出し、リスト、表を保持
• HTML / URL — メイン記事の抽出、GFM 表、リンクを絶対 URL に解決
• Markdown / プレーンテキスト — 正規化してそのまま渡す

上限：ドキュメント 1 件につき 25 MB。

設定

変数	必須	用途
AGENTMD_API_KEY	はい	API キー
AGENTMD_BASE_URL	いいえ	別のデプロイ先を指定（セルフホスト、ステージング）

料金

最初の 50 回の変換は無料です（メールアドレスごと、クレジットカード不要）。その後は、変換が成功するごとに $0.002 が毎月請求されます。座席ごとのライセンスはなく、エージェントが実際に行った呼び出し分のみお支払いいただきます。

ライセンス

MIT（このクライアント用シム）。ホストされたサービスには独自の利用規約があります。