Orion Vision MCP Server 🚀

🔌 兼容 Cline、Cursor、Claude Desktop 以及其他任何 MCP 客户端！

Orion Vision MCP 也兼容任何 MCP 客户端

模型上下文协议 (MCP) 是一个开放标准，使 AI 系统能够与各种数据源和工具无缝交互，促进安全的双向连接。

Orion Vision MCP 服务器提供：

• 与 Azure 表单识别器/文档智能的无缝集成
• 文档分析和表单数据提取功能
• 支持多种文档类型（收据、发票、身份证件等）
• 使用 TypeScript 的类型安全操作

前提条件 🔧

在开始之前，请确保您具备以下条件：

• Azure 表单识别器/文档智能端点和密钥
• Claude Desktop 或 Cursor
• Node.js (v20 或更高版本)
• Git 已安装（仅当使用 Git 安装方法时需要）

Orion Vision MCP 服务器安装 ⚡

使用 NPX 运行

npx -y orion-vision-mcp@latest

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 Orion Vision MCP 服务器：

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

配置 MCP 客户端 ⚙️

配置 Cline 🤖

在 Cline 中设置 Orion Vision MCP 服务器最简单的方法是通过市场一键安装：

1. 在 VS Code 中打开 Cline
2. 单击侧边栏中的 Cline 图标
3. 导航到 "MCP Servers" 标签页（四个方块）
4. 搜索 "Orion Vision" 并点击 "安装"
5. 当提示时，输入您的 Azure 表单识别器凭据

或者，您可以手动在 Cline 中设置 Orion Vision MCP 服务器：

1. 打开 Cline MCP 设置文件：

# 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

1. 将 Orion Vision 服务器配置添加到文件中：

{
  "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": []
    }
  }
}

1. 保存文件。如果 Cline 已经运行，则重启 Cline。

配置 Cursor 🖥️

注意：需要 Cursor 版本 0.45.6 或更高

要在 Cursor 中设置 Orion Vision MCP 服务器：

1. 打开 Cursor 设置
2. 导航到 Features > MCP Servers
3. 单击 "+ Add New MCP Server" 按钮
4. 填写以下信息：
   • 名称：输入服务器的昵称（例如，“orion-vision-mcp”）
   • 类型：选择“command”作为类型
   • 命令：输入运行服务器的命令：

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

   重要：将 your-endpoint 和 your-key 替换为您的 Azure 表单识别器凭据

配置 Claude Desktop 应用程序 🖥️

对于 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"

对于 Windows:

code %APPDATA%\Claude\claude_desktop_config.json

添加 Orion Vision 服务器配置：

{
  "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"
      }
    }
  }
}

在 Claude Desktop 应用程序中的使用 🎯

安装完成后，并且配置了 Claude 桌面应用程序后，您必须完全关闭并重新打开 Claude 桌面应用程序才能看到 orion-vision-mcp 服务器。您应该会在应用程序左下角看到一个锤子图标，表示可用的 MCP 工具。

Orion Vision 示例

1. 分析文档：

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

1. 提取表单数据：

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

1. 处理身份证件:

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

故障排除 🛠️

常见问题

1. 找不到服务器

   • 通过运行 npm --version 验证 npm 安装
   • 检查 Claude Desktop 配置语法
   • 通过运行 node --version 确保 Node.js 正确安装

2. Azure 表单识别器凭据问题

   • 确认您的 Azure 表单识别器端点和密钥有效
   • 检查配置中的凭据是否正确设置
   • 确认凭据周围没有空格或引号

3. 文档处理问题

   • 验证文档 URL 是否可访问
   • 检查文档格式是否受支持
   • 确保文档未损坏且未受密码保护

致谢 ✨

• Model Context Protocol 提供的 MCP 规范
• Anthropic 提供的 Claude Desktop
• Microsoft Azure 提供的表单识别器/文档智能