Florence-2

by jkawamoto

4 stars
199 downloads
Not rated
GitHub

About

Integrates with Florence-2 to enable advanced image analysis and manipulation tasks like visual question answering, image captioning, and content-based image retrieval.

Details

Author
jkawamoto
Repository
jkawamoto/mcp-florence2
GitHub stars
4
Downloads
199
License
MIT License
Categories
Productivity, Developer Tools, Design, AI, Media, Project Management, Frontend, Infrastructure, Other
Tags
#integration

- OCR for text extraction from images and PDFs
- Image caption generation
- Supports local file paths and remote URLs as input
- Easy one‑click installs for Claude, Goose, and LM Studio
- Runs via uvx for reproducible Python environments

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Florence-2
    Command (node, npx, python, etc.) uvx
    Arguments
    • Argument 1 --from
    • Argument 2 git+https://github.com/jkawamoto/mcp-florence2
    • Argument 3 mcp-florence2

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install via the pre-built .mcpb bundle (for Claude Desktop) or by adding manual configuration entries to the claude_desktop_config.json, Goose config.yaml, or LM Studio MCP settings. All configurations use uvx to run the server from the Git repository. The server exposes two tools: ocr (extract text) and caption (generate captions), both accepting a src argument (file path or URL).

ocr

Process an image file or URL using OCR to extract text. Arguments: src (file path or URL to the image file)

caption

Processes an image file and generates captions for the image. Arguments: src (file path or URL to the image file)

process

Processes an image file with a custom prompt using the Florence-2 model. Arguments: src (file path or URL to the image file), prompt (custom prompt for the Florence-2 model)

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

Linux

{
    "cwd": "string",
    "env": [],
    "args": [
        "--from",
        "git+https://github.com/jkawamoto/mcp-florence2",
        "mcp-florence2"
    ],
    "shell": false,
    "command": "uvx"
}

Macos

{
    "cwd": "string",
    "env": [],
    "args": [
        "--from",
        "git+https://github.com/jkawamoto/mcp-florence2",
        "mcp-florence2"
    ],
    "shell": false,
    "command": "uvx"
}

Windows

{
    "cwd": "string",
    "env": [],
    "args": [
        "--from",
        "git+https://github.com/jkawamoto/mcp-florence2",
        "mcp-florence2"
    ],
    "shell": false,
    "command": "uvx"
}

Florence-2 MCP Server

uv
Python Application
pre-commit
GitHub License

MseeP.ai Security Assessment Badge

An MCP server for processing images using Florence-2.

You can process images or PDF files stored on a local or web server to extract text using OCR (Optical Character
Recognition) or generate descriptive captions summarizing the content of the images.

Installation

Claude

Download the latest MCP bundle mcp-florence2.mcpb from the Releases page, then open the downloaded .mcpb file or drag it into the Claude Desktop's Settings window.

<details>
<summary>Manually configuration</summary>

You can also manually configure this server for Claude Desktop.
Edit the claude_desktop_config.json file by adding the following entry under mcpServers:

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

After editing, restart the application.

</details>

For more information,

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.