OpenRouter MCP 서버
OpenRouter.ai의 다양한 모델 생태계와 원활하게 통합되는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 내장된 캐싱, 속도 제한 및 오류 처리 기능을 갖춘 통합되고 유형이 안전한 인터페이스를 통해 다양한 AI 모델에 액세스하세요.
특징
- 모델 액세스
- 모든 OpenRouter.ai 모델에 직접 액세스
- 자동 모델 검증 및 기능 검사
- 기본 모델 구성 지원
- 성능 최적화
- 스마트 모델 정보 캐싱(1시간 만료)
- 자동 요금 제한 관리
- 실패한 요청에 대한 지수적 백오프
- 통합 응답 형식
- 모든 응답에 대한 일관된
ToolResult 구조 isError 플래그로 오류 식별을 지웁니다.- 컨텍스트가 포함된 구조화된 오류 메시지
설치
지엑스피1
구성
필수 조건
- OpenRouter Keys 에서 OpenRouter API 키를 받으세요
- 기본 모델을 선택하세요(선택 사항)
환경 변수
OPENROUTER_API_KEY=your-api-key-here
OPENROUTER_DEFAULT_MODEL=optional-default-model
설정
MCP 설정 구성 파일( cline_mcp_settings.json 또는 claude_desktop_config.json )에 다음을 추가합니다.
{
"mcpServers": {
"openrouterai": {
"command": "npx",
"args": ["@mcpservers/openrouterai"],
"env": {
"OPENROUTER_API_KEY": "your-api-key-here",
"OPENROUTER_DEFAULT_MODEL": "optional-default-model"
}
}
}
}
응답 형식
모든 도구는 표준화된 구조로 응답을 반환합니다.
interface ToolResult {
isError: boolean;
content: Array<{
type: "text";
text: string; // JSON string or error message
}>;
}
성공 사례:
{
"isError": false,
"content": [{
"type": "text",
"text": "{\"id\": \"gen-123\", ...}"
}]
}
오류 예:
{
"isError": true,
"content": [{
"type": "text",
"text": "Error: Model validation failed - 'invalid-model' not found"
}]
}
사용 가능한 도구
채팅_완료
OpenRouter.ai 모델에 메시지 보내기:
interface ChatCompletionRequest {
model?: string;
messages: Array<{role: "user"|"system"|"assistant", content: string}>;
temperature?: number; // 0-2
}
// Response: ToolResult with chat completion data or error
검색_모델
사용 가능한 모델을 검색하고 필터링하세요.
interface ModelSearchRequest {
query?: string;
provider?: string;
minContextLength?: number;
capabilities?: {
functions?: boolean;
vision?: boolean;
};
}
// Response: ToolResult with model list or error
모델 정보 얻기
특정 모델에 대한 자세한 정보를 얻으세요:
{
model: string; // Model identifier
}
모델 검증
모델 ID가 유효한지 확인하세요:
interface ModelValidationRequest {
model: string;
}
// Response:
// Success: { isError: false, valid: true }
// Error: { isError: true, error: "Model not found" }
오류 처리
서버는 구조화된 오류에 컨텍스트 정보를 제공합니다.
// Error response structure
{
isError: true,
content: [{
type: "text",
text: "Error: [Category] - Detailed message"
}]
}
일반적인 오류 범주:
Validation Error : 잘못된 입력 매개변수API Error : OpenRouter API 통신 문제Rate Limit : 요청 제한 감지Internal Error : 서버 측 처리 실패
응답 처리:
async function handleResponse(result: ToolResult) {
if (result.isError) {
const errorMessage = result.content[0].text;
if (errorMessage.startsWith('Error: Rate Limit')) {
// Handle rate limiting
}
// Other error handling
} else {
const data = JSON.parse(result.content[0].text);
// Process successful response
}
}
개발
자세한 내용은 CONTRIBUTING.md를 참조하세요.
- 개발 설정
- 프로젝트 구조
- 기능 구현
- 오류 처리 지침
- 도구 사용 예
# Install dependencies
pnpm install
# Build project
pnpm run build
# Run tests
pnpm test
변경 사항
최신 업데이트 내용은 CHANGELOG.md를 참조하세요.
- 통합 응답 형식 구현
- 향상된 오류 처리 시스템
- 유형 안전 인터페이스 개선
특허
이 프로젝트는 Apache License 2.0에 따라 라이선스가 부여되었습니다. 자세한 내용은 LICENSE 파일을 참조하세요.