Florence-2 MCP Server

Florence-2 MCP サーバー

Florence-2を使用して画像を処理するMCP サーバーです。

ローカルサーバーまたはウェブサーバーに保存された画像やPDFファイルを処理し、OCR（光学文字認識）でテキストを抽出したり、画像の内容を要約する説明的なキャプションを生成したりできます。

インストール

Claude

Releasesページから最新のMCPバンドル mcp-florence2.mcpb をダウンロードし、 ダウンロードした .mcpb ファイルを開くか、Claude Desktopの設定ウィンドウにドラッグします。

{
  "mcpServers": {
    "florence-2": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jkawamoto/mcp-florence2",
        "mcp-florence2"
      ]
    }
  }
}

詳しくは、 ローカルMCPサーバーへの接続 - Model Context Protocolを参照してください。

goose

このリンクを開いて

goose://extension?cmd=uvx&arg=--from&arg=git%2Bhttps%3A%2F%2Fgithub.com%2Fjkawamoto%2Fmcp-florence2&arg=mcp-florence2&id=florence2&name=Florence-2&description=An%20MCP%20server%20for%20processing%20images%20using%20Florence-2

インストーラーを起動し、「はい」をクリックしてインストールを確定します。

extensions:
  florence2:
    name: Florence-2
    cmd: uvx
    args: [ --from, git+https://github.com/jkawamoto/mcp-florence2, mcp-florence2 ]
    enabled: true
    type: stdio

GooseでのMCPサーバーの設定について詳しくは、ドキュメントを参照してください。 拡張機能の使用 | goose。

LM Studio

LM Studio向けにこのサーバーを設定するには、下のボタンをクリックします。

ツール

ocr

OCRを使用して画像ファイルまたはURLを処理し、テキストを抽出します。

引数：

• src：処理する画像ファイルのパスまたはURL。

caption

画像ファイルを処理し、画像のキャプションを生成します。

引数：

• src：処理する画像ファイルのパスまたはURL。

process

Florence-2モデル用のカスタムプロンプトを使用して画像ファイルを処理します。

引数：

• src：処理する画像ファイルのパスまたはURL。
• prompt：Florence-2モデル用のカスタムプロンプト。

セキュリティに関する考慮事項

URL（src パラメーターが http:// または https:// で始まるもの）から画像ファイルを処理する際、Python の requests ライブラリを使用して、サーバープロセスから直接 HTTP リクエストを送信します。信頼できないユーザーやプロンプトから URL が指定される可能性のある環境では、内部ネットワークサービスやクラウドのメタデータエンドポイントを狙ったサーバーサイドリクエストフォージェリ（SSRF）により、サーバーが危険にさらされるおそれがあります。

SSRF のリスクを軽減するため、すべての送信 HTTP(S) トラフィックを、SSRF 対策済みのフォワードプロキシ（Smokescreen や、内部 IP 範囲をブロックするよう設定された Squid など）経由で送信することを強く推奨します。

requests は標準の環境変数を自動的に参照するため、アプリケーションコードを変更せずにプロキシ設定を構成できます。

• HTTP_PROXY / http_proxy：HTTP リクエスト用のプロキシ URL。
• HTTPS_PROXY / https_proxy：HTTPS リクエスト用のプロキシ URL。
• NO_PROXY / no_proxy：プロキシを経由しないホストをカンマ区切りで指定したリスト。

設定例

Claude Desktop

claude_desktop_config.json に env ブロックを追加します。

{
  "mcpServers": {
    "florence-2": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jkawamoto/mcp-florence2",
        "mcp-florence2"
      ],
      "env": {
        "HTTP_PROXY": "http://proxy.example.com:8080",
        "HTTPS_PROXY": "http://proxy.example.com:8080"
      }
    }
  }
}

Goose

~/.config/goose/config.yaml に env ブロックを追加します。

extensions:
  florence2:
    name: Florence-2
    cmd: uvx
    args: [ --from, git+https://github.com/jkawamoto/mcp-florence2, mcp-florence2 ]
    env:
      HTTP_PROXY: "http://proxy.example.com:8080"
      HTTPS_PROXY: "http://proxy.example.com:8080"
    enabled: true
    type: stdio

ライセンス

このアプリケーションは MIT ライセンスのもとでライセンスされています。詳細については、LICENSE ファイルをご覧ください。