AgentMD

agentmd-mcp

适用于 AgentMD 的 MCP 服务——将 PDF、DOCX、HTML 和 URL 转换为整洁、适用于大模型的 Markdown，同时保留表格并剔除网页中的冗余内容。

Agent 会不断读取文档，而大多数文档格式都不便于大模型处理。此服务提供三个工具，可将这些文档转换为 Agent 能够实际读取的 Markdown。

安装

前往 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>" }
    }
  }
}

远程（无需安装）——托管服务可直接使用 streamable 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 编码）

三个工具都会返回 Markdown，并在开头附上检测到的标题和任何警告。

支持的格式

• PDF — 提取文本（扫描版或纯图像 PDF 会返回警告；OCR 已列入规划）
• DOCX — 保留标题、列表和表格
• HTML / URL — 提取文章主体、保留 GFM 表格，并将链接解析为绝对 URL
• Markdown / 纯文本 — 规范化后直接传递

限制：每份文档最大 25 MB。

配置

变量	必填	用途
AGENTMD_API_KEY	是	你的 API 密钥
AGENTMD_BASE_URL	否	指向其他部署（可自托管或用于预发布环境）

定价

前 50 次转换免费（按邮箱计算，无需银行卡）。之后，每次成功转换收费 $0.002，按月结算。不按席位授权——只需为 Agent 实际发起的调用付费。

许可证

MIT（此客户端垫片）。托管服务有其自己的条款。