Markovo CLI および MCP サーバー

Markovo は、対応ファイルおよび明示的に許可された公開 HTTPS ページを、構造化されたクリーンな Markdown に変換します。専用の Web エクスペリエンスと製品詳細については、PDF to 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. シェルまたは 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 to Markdown

• ドキュメント

• 料金とクレジット

• 開発者ポータルと API キー

• 課金とチャージアップ

セキュリティ

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