OpenRouter MCP 멀티모달 서버

OpenRouter.ai의 다양한 모델 생태계를 통해 채팅 및 이미지 분석 기능을 제공하는 MCP(Model Context Protocol) 서버입니다. 이 서버는 텍스트 채팅 기능과 강력한 이미지 분석 기능을 결합합니다.

특징

텍스트 채팅:
- 모든 OpenRouter.ai 채팅 모델에 직접 액세스
- 간단한 텍스트 및 다중 모드 대화 지원
- 구성 가능한 온도 및 기타 매개변수
이미지 분석:
- 사용자 정의 질문으로 단일 이미지 분석
- 여러 이미지를 동시에 처리
- 자동 이미지 크기 조정 및 최적화
- 다양한 이미지 소스(로컬 파일, URL, 데이터 URL) 지원
모델 선택:
- 사용 가능한 모델 검색 및 필터링
- 모델 ID 검증
- 자세한 모델 정보를 얻으세요
- 기본 모델 구성 지원
성능 최적화:
- 스마트 모델 정보 캐싱
- 재시도를 위한 지수적 백오프
- 자동 요금 제한 처리

1.5.0의 새로운 기능

향상된 OS 호환성:
- Windows, macOS 및 Linux에 대한 향상된 경로 처리
- 드라이브 문자가 포함된 Windows 스타일 경로에 대한 더 나은 지원
- 플랫폼 간 일관된 동작을 위한 정규화된 경로 처리
MCP 구성 지원:
- 환경 변수가 필요 없는 커서 MCP 통합
- MCP 매개변수를 통한 직접 구성
- 유연한 API 키 및 모델 사양 옵션
강력한 오류 처리:
- 이미지 처리를 위한 개선된 대체 메커니즘
- 특정 진단을 통한 더 나은 오류 보고
- 파일 읽기를 위한 다양한 백업 전략
이미지 처리 개선 사항:
- 모든 이미지 유형에 대해 더욱 안정적인 base64 인코딩
- Sharp 모듈을 사용할 수 없는 경우 대체 옵션
- 자동 최적화를 통해 대용량 이미지를 더 잘 처리합니다.

설치

옵션 1: npm을 통해 설치

지엑스피1

옵션 2: Docker를 통해 실행

docker run -i -e OPENROUTER_API_KEY=your-api-key-here stabgandocker/openrouter-mcp-multimodal:latest

빠른 시작 구성

필수 조건

OpenRouter Keys 에서 OpenRouter API 키를 받으세요
기본 모델을 선택하세요(선택 사항)

MCP 구성 옵션

다음 구성 중 하나를 MCP 설정 파일에 추가합니다(예: cline_mcp_settings.json 또는 claude_desktop_config.json ):

옵션 1: npx 사용(Node.js)

{
  "mcpServers": {
    "openrouter": {
      "command": "npx",
      "args": [
        "-y",
        "@stabgan/openrouter-mcp-multimodal"
      ],
      "env": {
        "OPENROUTER_API_KEY": "your-api-key-here",
        "DEFAULT_MODEL": "qwen/qwen2.5-vl-32b-instruct:free"
      }
    }
  }
}

옵션 2: uv(Python 패키지 관리자) 사용

{
  "mcpServers": {
    "openrouter": {
      "command": "uv",
      "args": [
        "run",
        "-m",
        "openrouter_mcp_multimodal"
      ],
      "env": {
        "OPENROUTER_API_KEY": "your-api-key-here",
        "DEFAULT_MODEL": "qwen/qwen2.5-vl-32b-instruct:free"
      }
    }
  }
}

옵션 3: Docker 사용

{
  "mcpServers": {
    "openrouter": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "OPENROUTER_API_KEY=your-api-key-here",
        "-e", "DEFAULT_MODEL=qwen/qwen2.5-vl-32b-instruct:free",
        "stabgandocker/openrouter-mcp-multimodal:latest"
      ]
    }
  }
}

옵션 4: 대장간 사용(권장)

{
  "mcpServers": {
    "openrouter": {
      "command": "smithery",
      "args": [
        "run",
        "stabgan/openrouter-mcp-multimodal"
      ],
      "env": {
        "OPENROUTER_API_KEY": "your-api-key-here",
        "DEFAULT_MODEL": "qwen/qwen2.5-vl-32b-instruct:free"
      }
    }
  }
}

예시

이 MCP 서버 사용 방법에 대한 포괄적인 예제는 예제 디렉토리를 참조하세요. 다음이 제공됩니다.

Node.js 애플리케이션을 위한 JavaScript 예제
대화형 채팅 기능을 갖춘 Python 예제
다양한 애플리케이션과 통합하기 위한 코드 조각

각 예제에는 명확한 설명서와 단계별 지침이 제공됩니다.

종속성

이 프로젝트는 다음과 같은 주요 종속성을 사용합니다.

@modelcontextprotocol/sdk : ^1.8.0 - 도구 구현을 위한 최신 MCP SDK
openai : ^4.89.1 - OpenRouter용 OpenAI 호환 API 클라이언트
sharp : ^0.33.5 - 빠른 이미지 처리 라이브러리
axios : ^1.8.4 - API 요청을 위한 HTTP 클라이언트
node-fetch : ^3.3.2 - 최신 fetch 구현

Node.js 18 이상이 필요합니다. 모든 종속성은 호환성과 보안을 보장하기 위해 정기적으로 업데이트됩니다.

사용 가능한 도구

mcp_openrouter_chat_completion

OpenRouter 모델에 텍스트 또는 다중 모드 메시지를 보냅니다.

use_mcp_tool({
  server_name: "openrouter",
  tool_name: "mcp_openrouter_chat_completion",
  arguments: {
    model: "google/gemini-2.5-pro-exp-03-25:free", // Optional if default is set
    messages: [
      {
        role: "system",
        content: "You are a helpful assistant."
      },
      {
        role: "user",
        content: "What is the capital of France?"
      }
    ],
    temperature: 0.7 // Optional, defaults to 1.0
  }
});

이미지가 포함된 다중 모드 메시지의 경우:

use_mcp_tool({
  server_name: "openrouter",
  tool_name: "mcp_openrouter_chat_completion",
  arguments: {
    model: "anthropic/claude-3.5-sonnet",
    messages: [
      {
        role: "user",
        content: [
          {
            type: "text",
            text: "What's in this image?"
          },
          {
            type: "image_url",
            image_url: {
              url: "https://example.com/image.jpg"
            }
          }
        ]
      }
    ]
  }
});

OpenRouter MCP Multimodal Server

Integrations