Orion Vision (Azure Form Recognizer) MCP server

The Orion Vision MCP server implements the Model Context Protocol standard to enable AI systems to interact with Azure Form Recognizer/Document Intelligence. It provides document analysis capabilities, form data extraction, and support for various document types like receipts, invoices, and ID documents.

Prerequisites

Before installation, ensure you have:

• Azure Form Recognizer / Document Intelligence endpoint and key
• Claude Desktop or Cursor
• Node.js (v20 or higher)
• Git installed (if using Git installation method)

Installation

Running with NPX

The simplest way to run Orion Vision MCP server:

npx -y orion-vision-mcp@latest

Installing via Smithery

For automatic installation with Claude Desktop:

npx -y @smithery/cli install @orion-vision/mcp --client claude

Configuring MCP Clients

Configuring Cline

Option 1: Marketplace Installation (Recommended)

1. Open Cline in VS Code
2. Click the Cline icon in the sidebar
3. Navigate to the "MCP Servers" tab (4 squares)
4. Search for "Orion Vision" and click "install"
5. Enter your Azure Form Recognizer credentials when prompted

Option 2: Manual Configuration

1. Open the Cline MCP settings file:

# For macOS:
code ~/Library/Application\ Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

# For Windows:
code %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

2. Add the Orion Vision server configuration:

{
  "mcpServers": {
    "orion-vision-mcp": {
      "command": "npx",
      "args": ["-y", "orion-vision-mcp@latest"],
      "env": {
        "AZURE_FORM_RECOGNIZER_ENDPOINT": "your-endpoint-here",
        "AZURE_FORM_RECOGNIZER_KEY": "your-key-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

3. Save and restart Cline if it's already running

Configuring Cursor

Note: Requires Cursor version 0.45.6 or higher

1. Open Cursor Settings
2. Go to Features > MCP Servers
3. Click "+ Add New MCP Server"
4. Fill out the form:
   • Name: Enter a nickname (e.g., "orion-vision-mcp")
   • Type: Select "command"
   • Command: Enter:

   env AZURE_FORM_RECOGNIZER_ENDPOINT=your-endpoint AZURE_FORM_RECOGNIZER_KEY=your-key npx -y orion-vision-mcp@latest
   

   (Replace your-endpoint and your-key with your Azure credentials)

Configuring Claude Desktop

1. Open the configuration file:

For macOS:

# Create the config file if it doesn't exist
touch "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# Opens the config file in TextEdit
open -e "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

For Windows:

code %APPDATA%\Claude\claude_desktop_config.json

2. Add the Orion Vision server configuration:

{
  "mcpServers": {
    "orion-vision-mcp": {
      "command": "npx",
      "args": ["-y", "orion-vision-mcp@latest"],
      "env": {
        "AZURE_FORM_RECOGNIZER_ENDPOINT": "your-endpoint-here",
        "AZURE_FORM_RECOGNIZER_KEY": "your-key-here"
      }
    }
  }
}

Usage

After configuring, completely close and reopen the Claude desktop app. You should see a hammer icon in the bottom left, indicating available MCP tools.

Example Commands

1. Analyze a Document:

Analyze the document at "https://example.com/document.pdf" using Azure Form Recognizer.

2. Extract Form Data:

Extract data from the invoice at "https://example.com/invoice.pdf".

3. Process ID Document:

Process the ID document at "https://example.com/id.pdf" and extract relevant information.

Troubleshooting

Common Issues

1. Server Not Found

   • Verify npm installation with npm --version
   • Check configuration syntax
   • Ensure Node.js is properly installed with node --version

2. Azure Form Recognizer Credentials Issues

   • Confirm your Azure credentials are valid
   • Check the credentials are correctly set in the config
   • Verify no spaces or quotes around the credentials

3. Document Processing Issues

   • Verify the document URL is accessible
   • Check the document format is supported
   • Ensure the document is not corrupted or password-protected

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "orion-vision-mcp" '{"command":"npx","args":["-y","orion-vision-mcp@latest"],"env":{"AZURE_FORM_RECOGNIZER_ENDPOINT":"your-endpoint-here","AZURE_FORM_RECOGNIZER_KEY":"your-key-here"},"disabled":false,"autoApprove":[]}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "orion-vision-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "orion-vision-mcp@latest"
            ],
            "env": {
                "AZURE_FORM_RECOGNIZER_ENDPOINT": "your-endpoint-here",
                "AZURE_FORM_RECOGNIZER_KEY": "your-key-here"
            },
            "disabled": false,
            "autoApprove": []
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "orion-vision-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "orion-vision-mcp@latest"
            ],
            "env": {
                "AZURE_FORM_RECOGNIZER_ENDPOINT": "your-endpoint-here",
                "AZURE_FORM_RECOGNIZER_KEY": "your-key-here"
            },
            "disabled": false,
            "autoApprove": []
        }
    }
}

3. Restart Claude Desktop for the changes to take effect