mcpField
U
unfold-mcp

unfold-mcp

ローカル
unfold.bytestay.pt生産性01 日前に更新
リポジトリ公式サイト

unfold-mcp について

unfold-mcpは、URLまたはローカルパスのPDF、DOCX、PPTX、XLSXをMarkdownに変換し、AIエージェントに提供します。stdioでローカル実行し、マーケットプレイスのキーでUnfold APIを利用します。

主な機能

  1. 01PDF、DOCX、PPTX、XLSXの変換
  2. 02URLとローカルファイルに対応
  3. 03文書形式の自動判定
  4. 04文字数上限を指定したMarkdown出力

活用シーン

  1. 01レポートの内容をAIエージェント向けに抽出
  2. 02表計算ファイルやプレゼン資料のMarkdown化
  3. 03公開URL上の文書の処理

MCP 対応

MCPクライアントに文書変換ツールを提供するMCPサーバーです。stdioでローカル実行し、Unfold APIを呼び出します。

設定

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

mcp.json · 共通設定
{
  "mcpServers": {
    "bytestay-unfold": {
      "command": "uvx",
      "args": [
        "bytestay-unfold-mcp"
      ],
      "env": {
        "RAPIDAPI_KEY": "<RAPIDAPI_KEY>",
        "API_MARKET_KEY": "<API_MARKET_KEY>",
        "BYTESTAY_MARKETPLACE": "<BYTESTAY_MARKETPLACE>"
      }
    }
  }
}
起動コマンドuvx bytestay-unfold-mcp
設定が必要な環境変数
RAPIDAPI_KEYシークレットYour RapidAPI key
API_MARKET_KEYシークレットYour api.market key, used when RAPIDAPI_KEY is not set
BYTESTAY_MARKETPLACErapidapi or apimarket, when both keys are set (the old name HFL_MARKETPLACE still works)

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

パッケージ
pypibytestay-unfold-mcp0.2.8

ツール

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

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

詳細

Unfold MCP サーバー

M8ven Score CI PyPI Python 3.10+ License: MIT

URLまたはローカルファイルから、PDF、Word（DOCX）、PowerPoint（PPTX）、Excel（XLSX）ドキュメントの内容をMarkdownとしてAIエージェントに提供します。

このサーバーはオープンソース（MIT）です。有料（無料プランあり）のUnfold APIを呼び出します。

  • RapidAPIまたはapi.marketで取得した、ご自身のキーを使用します。
  • ツールを呼び出すたびに、プランのリクエストを1回分消費します。
  • 無料のBasicプランは月15リクエストで、上限に達すると利用できなくなるため、料金が発生することはありません。

1. キーを取得する

マーケットプレイス
RapidAPIプラン
api.marketストア

2. MCP クライアントにサーバーを追加する

サーバーはuvを使い、stdio経由でローカル実行されます。キーは環境変数に設定してください。

JSON設定（Claude Desktop、Cursor、VS Code、およびほとんどのクライアント）：

{
  "mcpServers": {
    "unfold": {
      "command": "uvx",
      "args": ["--from", "bytestay-unfold-mcp", "unfold-mcp"],
      "env": { "RAPIDAPI_KEY": "your-rapidapi-key" }
    }
  }
}

Claude Code：

claude mcp add unfold --env RAPIDAPI_KEY=your-rapidapi-key -- uvx --from bytestay-unfold-mcp unfold-mcp
環境変数
変数意味
RAPIDAPI_KEYRapidAPIキー
API_MARKET_KEYapi.marketキー。RAPIDAPI_KEYが設定されていない場合に使用されます
HFL_MARKETPLACE両方のキーが設定されている場合は、rapidapiまたはapimarket

キーがなくてもサーバーは起動します。最初のツール呼び出し時に、キーの取得方法が説明されます。

Glamaにも掲載されています：

Glama上のunfold-mcp

3. ツール

ツール説明
convert_document(url=… | path=…, max_chars=20000)ドキュメント1件をMarkdownに変換します。公開URL、またはアップロードするローカルファイルを指定します

形式はコンテンツから判定されます。

各ツールはAPIのJSONレスポンスを返します。

  • マーケットプレイスから情報が提供される場合、quota_remainingが追加されます。これは、今月のプランで残っているリクエスト数です。
  • エラーは、次に行うべきこととともに平易な言葉で説明されます。
    • キーが拒否された場合は、登録用リンクが示されます。
    • クォータに達した場合は、プランが示されます。
    • APIが処理できなかった入力の場合は、APIから返された理由が示されます。

プライバシー

  • ローカルファイルは、ツールにそのパスを渡した場合にのみ読み込まれます。そのファイルは、そのリクエストの処理のためにAPIへ送信されます。
  • APIは入力をメモリ上で処理し、保存しません。プライバシーポリシーをご覧ください。
  • キーは、選択したマーケットプレイスにのみ送信されます。

制限事項

  • ローカルファイルは最大10 MBです。
  • Markdownは最大500,000文字です。
  • サーバーにはPython 3.10以上が必要です（uvがインストールします）。

開発

uv venv && uv pip install -e ".[dev]"
.venv/bin/pytest            # unit tests, no network; 100% coverage required
.venv/bin/ruff check src tests scripts

scripts/e2e_stdio.py unfoldは、クライアントと同じようにstdio経由でサーバーを実行し、実際のAPIに対してツールを呼び出します。RAPIDAPI_KEYまたはAPI_MARKET_KEYが必要です。

ライセンス

MITです。Unfold自体は無料プラン付きの有料APIで、ByteStayが運営しています。

コメント

Markdown 対応

MCP は初めてですか？

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

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