mcpField
D
Doc_Conv — Document to Markdown

Doc_Conv — Document to Markdown

ローカル
github.com/nicklee002e生産性02 週間前に更新
リポジトリ

Doc_Conv — Document to Markdown について

Doc_Convは、PDF、Word、Excel、PowerPointをMarkdownに変換するMCPサーバーです。LLMで扱う文書を準備するAgent向けで、無料見積もりに対応し、変換ごとにx402経由でBase上のUSDCを支払います。

主な機能

  1. 01対応文書をMarkdownに変換
  2. 02支払いなしで変換費用を見積もり
  3. 03Markdownまたは画像入りZIPを返却
  4. 04max_usdcで変換支出を上限設定

活用シーン

  1. 01LLM向けにPDFレポートを準備
  2. 02分析前にWordやPowerPointを変換
  3. 03変換料金を支払い前に確認

MCP 対応

MCPツールとして、文書の料金見積もりと変換を提供します。変換はx402経由でBase上のUSDCを支払い、見積もりには支払いやウォレットは不要です。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "nicklee002e-docconv": {
      "command": "uvx",
      "args": [
        "docconv-mcp"
      ],
      "env": {
        "DOC_CONV_AGENT_PK": "<DOC_CONV_AGENT_PK>",
        "DOC_CONV_BASE_URL": "<DOC_CONV_BASE_URL>"
      }
    }
  }
}
起動コマンドuvx docconv-mcp
設定が必要な環境変数
DOC_CONV_AGENT_PKシークレットPrivate key of the agent's Base wallet, used ONLY by convert_document to sign the x402 (EIP-3009) USDC payment. Leave unset to install and use estimate_conversion (free pricing) without a wallet. Secret - never commit or share.
DOC_CONV_BASE_URLBase URL of the Doc_Conv service. Defaults to the hosted service.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
pypidocconv-mcp1.0.2

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

docconv-mcp

Doc_Conv 用の MCP サーバーです。PDF／Word／Excel／PowerPoint ドキュメントを Markdown に変換します。変換ごとに Base 上の USDC で支払います。x402 プロトコルを使用します（ガス代不要、EIP-3009）。アカウントも API キーも不要です。エージェントが USDC で支払いに署名すると、サービスが Markdown を返します。

その理由は、書式付きファイル（PDF／PPT／DOCX）をそのまま LLM に読み込ませると、同じ内容を Markdown にした場合と比べて 5～50 倍のトークンを消費することがあるためです。この MCP サーバーを使えば、エージェントはドキュメントを使用前に低コストで変換できます。

ツール

  • estimate_conversion(file_path) — 無料の料金見積もり（pages、credits、priceUsdc、jobId、jobToken）。支払いも副作用もありません。
  • convert_document(file_path, max_usdc=1.0, poll_seconds=300) — x402 で支払って変換します（見積もり額が max_usdc を超える場合は拒否します）。テキストドキュメントの場合は markdown をインラインで返し、画像を含むドキュメントの場合は downloadUrl（zip）を返します。

ウォレットなしで試す

料金の確認は無料で、キー、アカウント、ウォレットは不要です。インストールして見積もりを依頼するだけです。

claude mcp add doc-conv -- uvx docconv-mcp

次に、「~/papers/report.pdf の変換費用はいくらですか？」 と尋ねると、エージェントが estimate_conversion を呼び出して回答します。実際に変換する場合にのみ、ウォレットを追加してください。

インストール

PyPI に docconv-mcp として公開されています。 uvx で実行する（インストール不要）か、pip install docconv-mcp を実行してください。

設定（環境変数）

変数説明デフォルト
DOC_CONV_AGENT_PKエージェントの Base ウォレットの秘密鍵（USDC を保有している必要があります）。x402 の支払いに署名します。必要なのは convert_document のみです。estimate_conversion はこの設定なしで動作します。秘密情報です。コミットしたり共有したりしないでください。(未設定：料金の確認のみ)
DOC_CONV_BASE_URLDoc_Conv サービスのベース URL。セルフホストする場合にのみ変更してください。https://converter.crepe.fund

ウォレットには Base 上の USDC が必要です。ガス代はサービスの x402 ファシリテーターが負担するため、エージェントに ETH は不要です。料金はドキュメントのサイズに応じて決まります。50 ページで 1 クレジット＝0.2 USDC です（正確な金額は estimate_conversion を呼び出して確認してください）。

Claude Desktop／Claude Code（claude_desktop_config.json または .mcp.json）

{
  "mcpServers": {
    "doc-conv": {
      "command": "uvx",
      "args": ["docconv-mcp"],
      "env": { "DOC_CONV_AGENT_PK": "0x<your-agent-wallet-private-key>" }
    }
  }
}

Claude Code のワンライナー：

claude mcp add doc-conv -- env DOC_CONV_AGENT_PK=0x<key> uvx docconv-mcp

使用例

「~/papers/report.pdf を Markdown に変換してください。」

エージェントは estimate_conversion を呼び出して料金（例：0.3 USDC）を確認し、次に convert_document を呼び出して x402 で支払い、Markdown を返します。変換に失敗した場合、支払い済みのクレジットは支払元のウォレットに保持され、再利用できます。

⚠️ convert_document は実際の USDC を使用します。呼び出しごとの費用を制限するには、max_usdc を設定してください。

リンク

ライセンス

MIT © CREPE Foundation

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。