Markovo File to Markdown

Markovo CLI と MCP サーバー

Markovo は、対応ファイルと、明示的に許可された公開 HTTPS ページを、整然と構造化された Markdown に変換します。専用のウェブ体験と製品の詳細については、PDF to Markdown Converter をご覧ください。

この公開リポジトリは、顧客側の 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 キーとクレジット

1. 開発者ポータルで API キーを作成します。
2. シェルまたは MCP ホストのシークレットストアに保存します。プロンプトに貼り付けたり、ソース管理にコミットしたりしないでください。
3. 設定を確認します。

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

各変換には、クレジットの上限を明示的に指定する必要があります。キーが設定されていない場合、クライアントは開発者ポータルを案内します。クレジットが不足している場合、サービスの応答は課金ページを案内するため、再試行する前にアカウントへチャージできます。

MCP の設定

リモート MCP（ホスト型エージェントに推奨）

Streamable HTTP エンドポイントに接続します。

https://markovo.net/mcp

MCP ホストは Markovo の OAuth 2.1 メタデータを検出し、Markovo アカウントのサインインと同意画面を開いて、スコープが設定された独自のトークンを保存します。このリモート接続では、API キーを作成、貼り付け、共有する必要はありません。リモートツールでは、機能、クレジット、所有するジョブを確認できます。また、必須の max_credit_units 上限を指定して、明示的に指定された公開 HTTPS ページを 1 つ変換したり、短期間有効な結果画像リンクを作成または無効化したりできます。リモート MCP からローカルファイルを読み取ることはできません。ローカルファイルを変換する必要がある場合は、以下の stdio パッケージを使用するか、REST のマルチパートアップロードを利用してください。

Markovo がクレジットを自動的にチャージしたり、プランを自動的に変更したりすることはありません。残高が少ない場合は、応答で 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"

構造化エラーでは、キーが設定されていない場合は開発者ポータルが、クレジットが不足している場合は課金ページが案内されます。

リンク

• Markovo ホーム
• PDF to Markdown
• ドキュメント
• リモート MCP ガイド
• 料金とクレジット
• 開発者ポータルと API キー
• 課金とチャージ

変換に問題が見つかりましたか？

再現可能なケースを [email protected] までご報告ください。問題を確認して修正した場合、Markovo Pro を 1 か月分お受け取りいただけます。

セキュリティ

セキュリティ上の問題は、SECURITY.md の手順に従って非公開でご報告ください。公開の Issue に API キー、顧客のドキュメント、非公開の変換結果を含めないでください。