Markovo File to Text, Word and Markdown

io.github.fisher-byte由 GitHub 账号 fisher-byte 发布v0.1.2更新于 Nov 6, 2026

Convert files and authorized public HTTPS pages to text, editable Word or Markdown.

已验证Streamable HTTP可网页运行效率与工作流文件与存储

概览

AI 生成的概览

Markovo 通过按账户计费的云服务,把受支持的文件和经授权的公开 HTTPS 页面转换为文本、可编辑 Word 或 Markdown。

可以做什么
  • 把本地文件或一个经明确授权的公开 HTTPS 页面转换为文本、Word 或 Markdown
  • 查询远程任务状态,并列出已完成任务中经清单校验的图片资源
  • 为结果图片创建和撤销短时有效的 bearer 链接,并校验已下载的 bundle
  • 查看账户 Credit 用量、实时能力清单、账单链接,以及客户端、服务与 API 密钥的就绪状态
适用场景
适合需要把 PDF、文档、图片、音频或视频转成可读文本、Word 或 Markdown,或把公开网页取回为结构化内容,又不想在本地运行转换引擎的场景。
运行要求
远程 Streamable HTTP 端点(OAuth 2.1 登录),或通过 uvx 运行的本地 stdio 包(Python)。本地模式需要来自 Markovo 开发者门户的 MARKOVO_API_KEY,以及专用的 MARKOVO_MCP_ROOT 目录;转换需要带 Credit 的 Markovo 账户。
安装前请注意
转换按账户计费并消耗 Credit,服务不会自动充值或变更套餐。API 密钥应存放在宿主密钥库中,不要写进提示词。本地文件工具受 MARKOVO_MCP_ROOT 限制,缺失时全部拒绝。URL 转换会把页面交给 Markovo 的远程抓取,资源链接是临时 bearer URL。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Markovo File to Text, Word and Markdown,将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储,绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.fisher-byte%2Fmarkovo/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。

{
  "mcpServers": {
    "markovo-file-to-text-word-and-markdown": {
      "type": "http",
      "url": "https://markovo.net/mcp"
    }
  }
}

README

Markovo CLI and MCP server

Markovo turns supported files and explicitly authorized public HTTPS pages into readable text, editable Word, or structured Markdown. For the dedicated web experience and product details, visit the PDF to Markdown Converter.

This public repository is the distribution source for the customer-side markovo CLI and the markovo-mcp stdio MCP server. It contains no local conversion engine, backend service, deployment configuration, production credentials, or billing implementation. Conversion runs through the account-metered service at https://markovo.net.

Install

bash
pip install "markovo==0.1.2"

Or run it without a permanent installation:

bash
uvx --from "markovo==0.1.2" markovo --helpuvx --from "markovo==0.1.2" markovo-mcp

Output formats

CLI 0.1.2+ accepts --download-format md, docx, or txt on file and URL conversions; the existing default is a verified Markdown ZIP bundle. Local stdio MCP uses the download_format argument. Hosted Remote MCP uses output_format. All formats reuse the same account and one conversion; downloading another format does not charge again. Files above 8MiB use bounded R2 upload parts instead of one full-file memory buffer. Image/document/audio limits are 25MiB on Free and 50MiB on Starter or Pro. Video limits are 200MiB/1h, 700MiB/2h and 2GiB/2h. Upgrade advice is returned only when a higher plan can accept the input; otherwise compress or split the file before retrying.

API key and Credits

  1. Create an API key in the Developer portal.
  2. Store it in your shell or MCP host secret store; do not paste it into prompts or commit it to source control.
  3. Verify the setup:
bash
export MARKOVO_API_KEY="your-key"markovo doctor --json

CLI and local stdio MCP use a 15-Credit convenience safety ceiling when their Credit limit is omitted. REST and direct client calls still require an explicit Credit ceiling. When a key is missing, the client points to the Developer portal. When Credits are insufficient, the service response points to the billing page so the account can be topped up before retrying.

MCP configuration

Remote MCP (recommended for hosted agents)

Connect the Streamable HTTP endpoint:

text
https://markovo.net/mcp

The MCP host discovers Markovo's OAuth 2.1 metadata, opens the Markovo account sign-in and consent screen, and stores its own scoped token. You do not create, paste, or share an API key for this remote connection. Remote tools can inspect capabilities, Credits, and owned jobs; convert one explicitly supplied public HTTPS page with a required max_credit_units ceiling; and create or revoke short-lived result-image links. Remote MCP cannot read local files. Use the stdio package below or REST multipart upload when a local file must be converted.

Markovo never tops up Credits or changes a plan automatically. A low balance response points to https://markovo.net/app#billing and waits for the account owner to act.

Local stdio MCP

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

MCP clients should inject MARKOVO_API_KEY through their secret or environment-variable settings. The key and service origin are never MCP tool arguments, so prompts cannot redirect the credential. The public client accepts only https://markovo.net and does not follow authenticated redirects.

The MCP server can read and write only within the required MARKOVO_MCP_ROOT. Set it to the smallest dedicated project directory your MCP host needs. If it is missing, the server refuses all file tools; parent-directory and symlink escapes are rejected.

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

Structured errors point to the Developer portal when a key is missing and to Billing when Credits are insufficient.

Links

Security

Report security issues privately using the instructions in SECURITY.md. Do not include API keys, customer documents, or private conversion results in a public issue.

来源:README.md,提交 32bef6c

工具

11

markovo_convert

Convert a supported file through the account-metered Markovo API.

输入参数modeout_dir必填input_path必填max_creditscapability_iddownload_formatlayout_fidelity

markovo_convert_url

Convert one public HTTPS page after explicit consent to Markovo's isolated remote fetch.

输入参数url必填out_dir必填max_creditspoll_attemptsdownload_formataccept_remote_fetch必填poll_interval_seconds

markovo_job_status

Fetch a remote job.

输入参数job_id

markovo_job_assets

List manifest-verified image assets for a completed job.

输入参数job_id

markovo_asset_url

Create a revocable 60-600 second bearer URL for one Bundle image.

输入参数job_idasset_pathexpires_in_seconds

markovo_asset_revoke

Revoke a temporary asset URL before it expires.

输入参数job_idgrant_id

markovo_usage

Fetch account Credit usage.

无需输入参数。

markovo_capabilities

Fetch the live capability registry.

无需输入参数。

markovo_billing

Return the secure billing URL.

无需输入参数。

markovo_bundle_verify

Verify a downloaded Markovo bundle.

输入参数bundle

markovo_doctor

Check client, service, and API-key readiness.

无需输入参数。

版本历史

2
  1. v0.1.2最新Oct 30, 2026
  2. v0.1.1Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分