Markovo CLI 和 MCP 服务器

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

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

安装

pip install markovo

或者无需永久安装即可运行：

uvx markovo --help
uvx --from markovo markovo-mcp

Related MCP server: MarkItDown MCP Server

API 密钥和积分

1. 在开发者门户中创建 API 密钥。

2. 将其存储在您的 shell 或 MCP 主机的密钥存储中；不要将其粘贴到提示中或提交到源代码管理。

3. 验证设置：

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

每次转换都需要明确的积分上限。当密钥缺失时，客户端会指向开发者门户。当积分不足时，服务响应会指向计费页面，以便在重试前为账户充值。

MCP 配置

{
  "mcpServers": {
    "markovo": {
      "command": "uvx",
      "args": ["--from", "markovo", "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"

当密钥缺失时，结构化错误会指向开发者门户；当积分不足时，会指向计费页面。

链接

• Markovo 主页

• PDF 转 Markdown

• 文档

• 定价和积分

• 开发者门户和 API 密钥

• 计费和充值

安全

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