Markovo File to Markdown

Markovo CLI 和 MCP 服务

Markovo 可将支持的文件和经明确授权的公开 HTTPS 页面转换为整洁、结构化的 Markdown。如需了解专门的网页体验和产品详情，请访问 PDF 转 Markdown 转换器。

此公开仓库是面向客户的 markovo CLI 和 markovo-mcp stdio MCP 服务的分发源。它不包含本地转换引擎、后端服务、部署配置、生产凭据或计费实现。转换通过按账户计量的服务 https://markovo.net 进行。

安装

pip install "markovo==0.1.1"

也可以运行而不进行永久安装：

uvx --from "markovo==0.1.1" markovo --help
uvx --from "markovo==0.1.1" markovo-mcp

API 密钥和 Credits

1. 在开发者门户中创建 API 密钥。
2. 将密钥存储在 shell 或 MCP 主机的机密存储中；不要将其粘贴到提示词中，也不要提交到源代码管理。
3. 验证设置：

export MARKOVO_API_KEY="your-key"
markovo doctor --json

每次转换都必须明确设置 Credits 上限。缺少密钥时，客户端会指引你前往开发者门户。Credits 不足时，服务响应会指引你前往账单页面，以便为账户充值后重试。

MCP 配置

远程 MCP（托管 Agent 推荐）

连接 Streamable HTTP 端点：

https://markovo.net/mcp

MCP 主机会发现 Markovo 的 OAuth 2.1 元数据，打开 Markovo 账户登录和授权页面，并存储其自身的限定范围令牌。远程连接无需创建、粘贴或共享 API 密钥。远程工具可以检查功能、Credits 和自有任务；转换一个明确提供的公开 HTTPS 页面（必须设置 max_credit_units 上限）；以及创建或撤销短期结果图片链接。远程 MCP 无法读取本地文件。需要转换本地文件时，请使用下方的 stdio 包或 REST multipart 上传。

Markovo 绝不会自动为 Credits 充值或更改套餐。余额不足时，响应会指引你前往 https://markovo.net/app#billing，并等待账户所有者采取操作。

本地 stdio MCP

{
  "mcpServers": {
    "markovo": {
      "command": "uvx",
      "args": ["--from", "markovo==0.1.1", "markovo-mcp"],
      "env": {
        "MARKOVO_API_KEY": "${MARKOVO_API_KEY}",
        "MARKOVO_MCP_ROOT": "/path/to/safe/project"
      }
    }
  }
}

MCP 客户端应通过机密或环境变量设置注入 MARKOVO_API_KEY。密钥和服务源地址都不是 MCP 工具参数，因此提示词无法重定向凭据。公开客户端只接受 https://markovo.net，且不会跟随经过身份验证的重定向。

MCP 服务只能在必需的 MARKOVO_MCP_ROOT 目录内读取和写入文件。请将其设为 MCP 主机所需的最小专用项目目录。如果未设置，服务将拒绝所有文件工具；越出父目录或通过符号链接越界的操作都会被拒绝。

export MARKOVO_MCP_ROOT="/path/to/safe/project"

结构化错误会在缺少密钥时指引你前往开发者门户，在 Credits 不足时指引你前往账单页面。

链接

• Markovo 首页
• PDF 转 Markdown
• 文档
• 远程 MCP 指南
• 定价和 Credits
• 开发者门户和 API 密钥
• 账单和充值

发现转换问题？

请向 [email protected] 报告可复现的问题。如果我们确认并修复了问题，你将获得 1 个月的 Markovo Pro。

安全

请按照 SECURITY.md 中的说明，私下报告安全问题。请勿在公开问题中包含 API 密钥、客户文档或私人转换结果。