BiGapi — file operations for AI agents

@bigapi/mcp

bigapi.dev の MCP サーバーです。AI エージェントの出力レイヤーです。

エージェントが何かを作成したら、bigapi が完成したファイルに仕上げ、ファイルの読み取りにも対応します。 結合、墨消し、OCR、変換、署名、検証など、LLM が自力では実行できない処理を、HTTPS 経由で、キーひとつ、サーバー側へのインストールなしで実行できます。

1 回の処理につき $0.01。100 回分は無料です。無料枠と残高に有効期限はありません。失敗した呼び出しは無料です。 ドイツのサーバーを使用し、GDPR に準拠しています。ファイルは配信後に削除されます。各処理には、説明どおりに動作することを証明する公開済みの証明が付属します。

公式の MCP Registry にも dev.bigapi/mcp として登録されています。

デフォルトは軽量

サーバーは軽量な状態で起動し、5 つのツールだけを一覧表示するため、コンテキストを節約できます。

ツール	機能
find_tool	作業内容を平易な言葉で説明すると、該当する処理と、そのまま実行できる例が表示されます。無料で、キーは不要です。
run_operation	クライアントの起動後に追加されたものも含め、bigapi のあらゆる処理を名前で実行します。
enable_tools	["pdf_redact","ocr"] や ["all"] のように、専用ツールを必要に応じて読み込みます。
get_access / get_balance	無料キーを取得し、クレジットを確認します。

40 以上のすべての処理は、起動直後から run_operation で利用できます。専用ツールは便利な選択肢であり、必須ではありません。すぐに全リストを表示するには、 サーバー環境で BIGAPI_TOOLS=all を設定してください。

理由：ツール定義はクライアントのコンテキストを消費します。モデルが 46 個の説明を確認するより、5 個から選ぶほうが適切に選択できます。

実行できる処理

40 以上のすべての処理は、run_operation（または enable_tools 後に利用できる専用ツール）から実行できます。 この一覧を覚える代わりに、平易な言葉で find_tool に尋ねてください。

• PDF の基本処理 — 結合、分割、回転、圧縮、ページ情報、アウトライン、比較、リニアライズ
• PDF のコンテンツ — Markdown へ変換、画像へ変換、表の抽出、添付ファイルの抽出（ZUGFeRD / Factur-X の請求書 XML）
• PDF の安全対策 — 墨消し（ラスター化して再構築し、テキストが確実に消去されます）、サニタイズ（JavaScript、アクション、埋め込みファイル）、パスワードの設定／解除、署名の検証
• PDF のアーカイブ — 埋め込みフォントと出力インテントを備えた PDF/A-2b。veraPDF で検証済みです
• ドキュメント — Office ファイルや電子書籍を PDF または Markdown に変換（DOCX、XLSX、PPTX、ODT、EPUB）、Markdown を Word に変換、.eml を PDF に変換
• Web とレンダリング — HTML／Markdown／URL を PDF または PNG に変換、デバイスプリセットを使った全ページのスクリーンショット、HTML または URL を整形済み Markdown に変換、Handlebars テンプレート、グラフ、QR コード
• 画像 — サイズ変更、切り抜き、変換（WebP/AVIF/…）、圧縮、メタデータの削除、透かし、画像情報
• AI の透明性 — C2PA Content Credentials の署名と検証、EXIF マーキングを伴う「AI-generated」ラベルの表示（EU AI Act Art. 50）
• RAG 用テキスト — トークンベースの分割、見出しを考慮した分割、オーバーラップ
• アカウント — 無料キー、残高、使用状況、月間上限、料金

インストール

Node 18+ が必要です。最初に API キーを用意する必要はありません。エージェント自身が get_access を呼び出せます。

Claude Desktop

claude_desktop_config.json（Settings → Developer → Edit Config）：

{
  "mcpServers": {
    "bigapi": {
      "command": "npx",
      "args": ["-y", "@bigapi/mcp"]
    }
  }
}

Claude Desktop を再起動します。次に、*「bigapi のアクセス権を取得して、このテキストを Desktop 上の PDF に変換して。」*と依頼してください。

Cursor / Windsurf / Cline

各 MCP 設定（.cursor/mcp.json、~/.codeium/windsurf/mcp_config.json、Cline → MCP Servers → Configure）に同じブロックを追加します。

既存のキーを使う場合

"bigapi": { "command": "npx", "args": ["-y", "@bigapi/mcp"], "env": { "BIGAPI_KEY": "bigapi_..." } }

ファイルの仕組み

入力にはローカルパス（/Users/me/report.pdf、C:\Users\me\scan.pdf）を指定します。出力は、指定した場合は output_path に、それ以外の場合は一時フォルダーに書き込まれます（変更するには BIGAPI_OUTPUT_DIR を設定します）。すべての結果には、費用、請求元、残高が含まれます。

料金

一律 1 回の操作につき $0.01 — すべての操作が対象で、例外はありません（ocr、office_to_pdf、pdf_to_markdown、pdf_extract_tables、pdf_compare、pdf_redact はページ単位）。$5 から前払いできます — サブスクリプション不要、登録不要、残高の有効期限なし、失敗した呼び出しは無料です。機械可読な情報は get_pricing または GET /v1/pricing で取得できます。

環境変数

変数	デフォルト値	用途
BIGAPI_KEY	–	保存済みのキーの代わりにこのキーを使用します
BIGAPI_CONFIG_DIR	~/.bigapi	get_access がキーを保存する場所（config.json、モード 600）
BIGAPI_OUTPUT_DIR	OS の一時ディレクトリ	デフォルトの出力フォルダー
BIGAPI_URL	https://api.bigapi.dev	API のベース URL（セルフホスト／テスト用）

MCP を使わない場合

プレーンな HTTP はどこでも動作します（n8n、Make、Zapier、LangChain、独自コードなど）。

curl -X POST https://api.bigapi.dev/v1/keys                       # → key
curl -o out.pdf https://api.bigapi.dev/v1/render \
  -H "Authorization: Bearer $KEY" -H "content-type: application/json" \
  -d '{"markdown":"# Hello from an agent"}'

OpenAPI：https://api.bigapi.dev/openapi.json · ドキュメント：https://api.bigapi.dev/docs · ガイド：https://bigapi.dev/guides/ · llms.txt：https://api.bigapi.dev/llms.txt

ライセンス

MIT