오리온 비전 MCP 서버 🚀

🔌 Cline, Cursor, Claude Desktop 및 기타 MCP 클라이언트와 호환됩니다!
Orion Vision MCP는 모든 MCP 클라이언트와도 호환됩니다.

MCP(Model Context Protocol)는 AI 시스템이 다양한 데이터 소스 및 도구와 원활하게 상호 작용할 수 있도록 하는 개방형 표준으로, 안전한 양방향 연결을 용이하게 합니다.

Orion Vision MCP 서버는 다음을 제공합니다.

Azure Form Recognizer/Document Intelligence와의 원활한 통합
문서 분석 및 양식 데이터 추출 기능
다양한 문서 유형(영수증, 송장, 신분증 등) 지원
TypeScript를 사용한 유형 안전 작업

필수 조건 🔧

시작하기 전에 다음 사항을 확인하세요.

Azure Form Recognizer/Document Intelligence 엔드포인트 및 키
클로드 데스크탑 또는 커서
Node.js(v20 이상)
Git 설치됨(Git 설치 방법을 사용하는 경우에만 필요)

Orion Vision MCP 서버 설치 ⚡

NPX로 실행

지엑스피1

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 Orion Vision MCP 서버를 자동으로 설치하려면:

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

MCP 클라이언트 구성 ⚙️

Cline 구성 🤖

클라인에 Orion Vision MCP 서버를 설정하는 가장 쉬운 방법은 마켓플레이스를 통해 한 번의 클릭으로 설정하는 것입니다.

VS Code에서 Cline 열기
사이드바에서 Cline 아이콘을 클릭하세요
"MCP 서버" 탭(4개 사각형)으로 이동합니다.
"Orion Vision"을 검색하고 "설치"를 클릭하세요.
메시지가 표시되면 Azure Form Recognizer 자격 증명을 입력하세요.

또는 Cline에서 Orion Vision MCP 서버를 수동으로 설정할 수 있습니다.

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

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

파일을 저장하고 Cline이 이미 실행 중이면 다시 시작합니다.

커서 구성 🖥️

참고 : 커서 버전 0.45.6 이상이 필요합니다.

Cursor에서 Orion Vision MCP 서버를 설정하려면:

커서 설정 열기
기능 > MCP 서버로 이동
"+ 새 MCP 서버 추가" 버튼을 클릭하세요
다음 정보를 입력하세요:
- 이름 : 서버의 별명을 입력하세요(예: "orion-vision-mcp")
- 유형 : 유형으로 "명령"을 선택하세요
- 명령어 : 서버를 실행하기 위한 명령어를 입력하세요: GXP5
  중요 : your-endpoint 및 your-key Azure Form Recognizer 자격 증명으로 바꾸세요.

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 데스크톱 앱에서의 사용법 🎯

설치가 완료되고 Claude 데스크톱 앱 구성이 완료되면 Claude 데스크톱 앱을 완전히 닫았다가 다시 열어야 orion-vision-mcp 서버를 확인할 수 있습니다. 앱 왼쪽 하단에 사용 가능한 MCP 도구를 나타내는 망치 아이콘이 표시됩니다.

오리온 비전 예시

문서 분석 :

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

양식 데이터 추출 :

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

프로세스 ID 문서 :

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

문제 해결 🛠️

일반적인 문제

서버를 찾을 수 없습니다
- npm --version 실행하여 npm 설치를 확인하세요.
- Claude Desktop 구성 구문 확인
- node --version 실행하여 Node.js가 제대로 설치되었는지 확인하세요.
Azure Form Recognizer 자격 증명 문제
- Azure Form Recognizer 엔드포인트와 키가 유효한지 확인하세요.
- 구성에서 자격 증명이 올바르게 설정되었는지 확인하세요.
- 자격 증명 주위에 공백이나 따옴표가 없는지 확인하세요.
문서 처리 문제
- 문서 URL에 접근할 수 있는지 확인하세요
- 문서 형식이 지원되는지 확인하세요
- 문서가 손상되었거나 암호로 보호되지 않았는지 확인하세요.

감사의 말 ✨

MCP 사양을 위한 모델 컨텍스트 프로토콜
클로드 데스크탑을 위한 인류학
Microsoft Azure for Form Recognizer/Document Intelligence