@devrobotlabs/visionapi-mcp

Vision API 用のMCPサーバーです。Claude Code、Claude Desktop、Cursor、その他のMCPホストをスキャンフォルダに向けて、請求書を依頼するだけです。統合コードを書く必要も、生成コードにAPIキーを埋め込む必要も、記憶から契約を言い換える必要もありません。

You: pull the totals out of every invoice in ~/inbox and put them in a CSV

Claude: [vision_analyze × 7]
        Done — 7 invoices, 14 credits. Three had no PO number; I left those cells empty.

インストール

インストールするものはありません。ホストの設定に追加すれば、npx 経由で実行されます。

Claude Code — claude mcp add visionapi --env VISION_API_KEY=sk_live_... -- npx -y @devrobotlabs/visionapi-mcp ~/inbox

Claude Desktop — claude_desktop_config.json:

{
  "mcpServers": {
    "visionapi": {
      "command": "npx",
      "args": ["-y", "@devrobotlabs/visionapi-mcp", "/Users/me/inbox"],
      "env": { "VISION_API_KEY": "sk_live_..." }
    }
  }
}

Cursor — .cursor/mcp.json、同じ構成:

{
  "mcpServers": {
    "visionapi": {
      "command": "npx",
      "args": ["-y", "@devrobotlabs/visionapi-mcp", "."],
      "env": { "VISION_API_KEY": "sk_live_..." }
    }
  }
}

VS Code — .vscode/mcp.json:

{
  "servers": {
    "visionapi": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@devrobotlabs/visionapi-mcp", "${workspaceFolder}"],
      "env": { "VISION_API_KEY": "sk_live_..." }
    }
  }
}

キーは app.visionapi.io/dashboard/keys で取得できます。新規アカウントには50クレジットが付与され、カードは不要です。

ホスト設定のブロックは、examples/ ディレクトリではなくこのREADMEに置いてあります——9つのクライアントライブラリからの意図的な変更です。READMEにしか存在しないスニペットは、誰も実行しない実行可能スクリプトから乖離することはありません。

Related MCP server: receiptconverter-mcp

読み取り可能なディレクトリ

位置引数はすべて、サーバーがファイルを読み取ってもよいディレクトリです。 何も指定しない場合、プロセスの作業ディレクトリだけが唯一のルートになります——これは安全なデフォルトです。MCPホストはプロジェクトディレクトリをcwdとしてstdioサーバーを起動するからです。

これは見た目以上に重要です。このサーバーは有効な支出用クレデンシャルを保持し、シェルの権限で実行されるため、シェルが読み取れるものは何でも読み取れます。~/Documents/passport.jpg の生テキストを要求することは、そのドキュメントの内容をモデルのコンテキストとホストが保持するトランスクリプトに取り込む、実際に機能する方法です。許可リストは、混乱した、または操作されたエージェントが誤ってそうするのを防ぐものです。

パスは比較前に両方の側で realpath で解決されるため、許可されたディレクトリ内のシンボリックリンクがその外を指すことはできません。

--allow-any-path は許可リストを完全に無効にします。起動時にstderrに警告を出力し、使用には理由が必要です。

ツール

クレジットを消費する3つのツールは readOnlyHint: false と注釈されているため、読み取り専用ツールを自動承認するホストでも、それらの1つが実行される前に停止して確認を求めます。

カタログはリソースとしても公開されています——visionapi://presets と visionapi://presets/{name}——リソースを好むホスト向けです。ツールが主要なインターフェースです。リソースのサポートはホストによって不均一だからです。

出力

レスポンスはモデルが読めるようにレンダリングされ、JSONとしてダンプされることはありません。37フィールドの請求書プリセットが、そのうち12フィールドを埋めるドキュメントに対して返す場合、テーブルと Not found in this document (25): … の1行として返されます——{"value":null,"confidence":"low"} の25回の繰り返しではなく——3〜4倍小さく、処理しやすくなります。

その過程で失われるものはありません。すべてのツールは format を受け取ります:

• markdown (デフォルト) — 上記のレンダリング。

• compact_json — 同じ情報をデータとして、_not_found と _low_confidence の配列付き。エージェントが読むのではなく解析する場合用。

• json — APIレスポンスをそのまま。契約に対して実際のHTTPコードを書くときに使うもの。

信頼度は高くない場合にのみ表示されるため、(mid) と (low) が目立ち、一般的なケースでは読むコストがかかりません。

長いドキュメント

mode は auto のままにしてください。APIは同期リクエストを60秒で終了します。サーバーはその後、リクエストをキューに再送信してポーリングし、進行状況をホストに報告します。課金は1回だけです。タイムアウトした試行が予約を完全に解放したからです。

約10ページを超えるものには事前に mode: "async" を渡し、長いドキュメントを安くサンプリングするには pages: "1-5" を渡してください——選択したページのみが課金されます。

コストと失敗

失敗はコストがかかりません。すべての非2xxレスポンスはクレジット予約を完全に解放するため、失敗した呼び出しは修正して再試行しても安全で、クリーンアップの必要はありません。ツールの説明にその旨が記載されているため、このサーバーを使用するエージェントはエラー後も賢明に動作し、諦めたり、機能しないものを再試行したりしません。

2つのエラーには、自分でも知っておく価値のあるアドバイスが含まれています:

環境変数

キーがなくてもサーバーの起動は止まりません: stderrに警告し、tools/list は引き続き機能し、最初の課金対象呼び出しは修正方法を示すメッセージを返します。起動を拒否するサーバーは、ユーザーに何かが壊れているとしか伝えません。

開発

npm install
npm run typecheck
npm test          # 37 offline tests — no key, no network
npx @modelcontextprotocol/inspector node ./dist/cli.js ~/some/dir

npm install --no-save ../node でクライアントのローカルビルドをテストします。npm install ../node ではありません——これは package.json を "file:../node" に書き換え、そのマニフェストが公開されるものだからです。

リンク

• ドキュメント

• コーディングエージェント向け統合リファレンス

• プリセットカタログ

• 料金

MITライセンス。