MCP 대화형 서버

OpenRouter 언어 모델을 사용하여 대화를 관리하기 위한 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다. 이 서버는 통합 대화 관리 시스템을 통해 애플리케이션이 다양한 언어 모델과 상호 작용할 수 있도록 표준화된 인터페이스를 제공합니다.

특징

MCP 프로토콜 지원
- 전체 MCP 프로토콜 준수
- 자원 관리 및 발견
- 도구 기반 상호작용 모델
- 스트리밍 응답 지원
- 오류 처리 및 복구
OpenRouter 통합
- 모든 OpenRouter 모델 지원
- 실시간 스트리밍 응답
- 자동 토큰 계산
- 모델 컨텍스트 창 관리
- 사용 가능한 모델은 다음과 같습니다.
  - 클로드 3 작품
  - 클로드 3 소네트
  - 라마 2 70B
  - OpenRouter 카탈로그에서 더 많은 것을 찾아보세요.
대화 관리
- 여러 대화를 만들고 관리하세요
- 시스템 메시지 지원
- 메시지 기록 추적
- 토큰 사용 모니터링
- 대화 필터링 및 검색
스트리밍 지원
- 실시간 메시지 스트리밍
- 청크 응답 처리
- 토큰 카운팅
파일 시스템 지속성
- 대화 상태 지속성
- 구성 가능한 저장 위치
- 자동 상태 관리

설치

지엑스피1

구성

MCP 대화형 서버의 모든 구성은 이제 YAML을 통해 제공됩니다. config/models.yaml 파일을 원하는 설정으로 업데이트하세요. 예:

# MCP Server Configuration
openRouter:
  apiKey: "YOUR_OPENROUTER_API_KEY"  # Replace with your actual OpenRouter API key.

persistence:
  path: "./conversations"  # Directory for storing conversation data.

models:
  # Define your models here
  'provider/model-name':
    id: 'provider/model-name'
    contextWindow: 123456
    streaming: true
    temperature: 0.7
    description: 'Model description'

# Default model to use if none specified
defaultModel: 'provider/model-name'

서버 구성

MCP 대화 서버는 이제 YAML 파일에서 모든 구성을 로드합니다. 애플리케이션에서 다음과 같이 구성을 로드할 수 있습니다.

const config = await loadModelsConfig(); // Loads openRouter, persistence, models, and defaultModel settings from 'config/models.yaml'

참고: 모든 구성이 YAML 파일을 통해 제공되므로 환경 변수는 더 이상 필요하지 않습니다.

용법

기본 서버 설정

import { ConversationServer } from 'mcp-conversation-server';

const server = new ConversationServer(config);
server.run().catch(console.error);

사용 가능한 도구

서버는 여러 가지 MCP 도구를 제공합니다.

대화 만들기
{ provider: 'openrouter', // Provider is always 'openrouter' model: string, // OpenRouter model ID (e.g., 'anthropic/claude-3-opus-20240229') title?: string; // Optional conversation title }
메시지 보내기
{ conversationId: string; // Conversation ID content: string; // Message content stream?: boolean; // Enable streaming responses }
목록 대화
{ filter?: { model?: string; // Filter by model startDate?: string; // Filter by start date endDate?: string; // Filter by end date } }

자원

서버는 다양한 리소스에 대한 액세스를 제공합니다.

대화://{id}
- 특정 대화 세부 정보에 액세스
- 메시지 기록 보기
- 대화 메타데이터 확인
대화://목록
- 모든 활성 대화 나열
- 기준에 따라 대화 필터링
- 최근 활동순으로 정렬

개발

건물

npm run build

테스트 실행

npm test

디버깅

서버는 여러 가지 디버깅 기능을 제공합니다.

오류 로깅
- 모든 오류는 스택 추적으로 기록됩니다.
- 토큰 사용 추적
- 속도 제한 모니터링
MCP 검사관
npm run inspector
MCP 검사기를 사용하여 다음을 수행할 수 있습니다.
- 테스트 도구 실행
- 리소스 내용 보기
- 메시지 흐름 모니터링
- 프로토콜 준수 확인
공급자 검증
await server.providerManager.validateProviders();
검증합니다:
- API 키 유효성
- 모델 가용성
- 요금 제한 상태

문제 해결

일반적인 문제 및 해결 방법:

OpenRouter 연결 문제
- API 키가 유효한지 확인하세요
- OpenRouter 대시보드 에서 속도 제한을 확인하세요
- 모델 ID가 올바른지 확인하세요
- 신용 사용량 모니터링
메시지 스트리밍 오류
- 모델 스트리밍 지원 확인
- 연결 안정성을 확인하세요
- 토큰 한도 모니터링
- 시간 초과 설정 처리
파일 시스템 오류
- 디렉토리 권한 확인
- 경로 구성 확인
- 디스크 공간 모니터링
- 동시 액세스 처리

기여하다

저장소를 포크하세요
기능 브랜치 생성
변경 사항을 커밋하세요
지점으로 밀어 넣기
풀 리퀘스트 만들기

특허

ISC 라이센스