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 分