Markovo 是一个将受支持的文件和经明确授权的公开 HTTPS 页面转换为干净、结构化 Markdown 的工具，主要面向智能体（Agent）上下文场景。其公开仓库是 Markovo CLI 和 markovo-mcp stdio MCP 服务器的分发源，不包含本地转换引擎、后端服务、部署配置、生产凭据或计费实现；实际转换通过 https://markovo.net 的按账户计量服务完成。
主要能力方面，Markovo 支持将 PDF、DOCX、PPTX、XLSX 等文件以及经明确授权的公开页面（如 Google Docs、Notion、GitHub、Hacker News、YouTube）转换为结构化 Markdown。它提供两种 MCP 接入方式：远程 MCP（推荐用于托管型智能体）和本地 stdio MCP。远程 MCP 使用 Streamable HTTP 端点，MCP 主机可发现 Markovo 的 OAuth 2.1 元数据，打开 Markovo 账户登录与授权页面，并存储自己的作用域令牌，无需创建、粘贴或共享 API 密钥。远程工具可以检查能力、Credits 和拥有的任务；转换一个明确提供的公开 HTTPS 页面（需指定 max_credit_units 上限）；创建或撤销短期结果图片链接。远程 MCP 无法读取本地文件，如需转换本地文件，应使用 stdio 包或 REST 多部分上传。
使用方式上，用户需在开发者门户创建 API 密钥，并将其存储在 shell 或 MCP 主机的密钥存储中，不要粘贴到提示词或提交到源代码管理。每次转换都需要明确的 Credit 上限。当密钥缺失时，客户端会指向开发者门户；当 Credits 不足时，服务响应会指向计费页面，以便账户充值后重试。本地 stdio MCP 要求 MCP 客户端通过密钥或环境变量设置注入 MARKOVO_API_KEY，密钥和服务源不会作为 MCP 工具参数，因此提示词无法重定向凭据。公开客户端仅接受 https://markovo.net，且不跟随经过身份验证的重定向。MCP 服务器只能在必需的 MARKOVO_MCP_ROOT 内读写，应将其设置为 MCP 主机所需的最小专用项目目录；如果缺失，服务器会拒绝所有文件工具，并拒绝父目录和符号链接逃逸。
适用场景包括为智能体提供结构化 Markdown 上下文、将文档或授权公开页面转换为 Markdown 等。限制方面，远程 MCP 不能读取本地文件；本地 stdio MCP 受 MARKOVO_MCP_ROOT 沙箱限制；Markovo 不会自动充值 Credits 或更改套餐，低余额响应会指向 https://markovo.net/app#billing 并等待账户所有者操作。若发现转换问题，可向 support@markovo.net 报告可复现案例，确认并修复后可获得 1 个月 Markovo Pro。安全问题的报告方式见 SECURITY.md，请勿在公开问题中包含 API 密钥、客户文档或私有转换结果。
