Palald/mcp-sdk-typescript

mcp-sdk-typescript은(는) 무엇을 하나요?

🚀 MCP SDK for TypeScript를 사용하여 최적화된 성능, 실시간 통신, 강력한 세션 관리를 갖춘 효율적인 애플리케이션을 구축하세요.

설치

npm install @palald/mcp-sdk-typescript

또는 Yarn을 사용하는 경우:

yarn add @palald/mcp-sdk-typescript

기본 사용법

import { MCPServer, MCPSession } from '@palald/mcp-sdk-typescript';

const server = new MCPServer({
  port: 3000,
  transport: 'websocket'
});

server.on('connection', (session: MCPSession) => {
  console.log('새 세션 연결됨:', session.id);
  
  session.on('message', (message) => {
    console.log('메시지 수신:', message);
    session.send('에코: ' + message);
  });
});

server.start();

주요 기능

• 최적화된 성능: 낮은 지연 시간과 높은 처리량을 위한 효율적인 이벤트 루프
• 실시간 통신: WebSocket 및 SSE(Server-Sent Events) 지원
• 세션 관리: 자동 연결 복구 및 상태 유지
• 타입 안전성: TypeScript 제네릭을 활용한 강력한 타입 추론
• 확장성: 플러그인 아키텍처를 통한 사용자 정의 기능 추가

API 참조

MCPServer

메서드	설명
start()	서버 시작
stop()	서버 중지
broadcast(message)	모든 연결된 클라이언트에 메시지 전송

MCPSession

속성	설명
id	고유 세션 식별자
state	현재 세션 상태 (connected, disconnected, reconnecting)

환경 변수

• MCP_PORT: 서버 포트 번호 (기본값: 3000)
• MCP_TRANSPORT: 전송 프로토콜 (websocket 또는 sse)

예제

자세한 예제는 examples/ 디렉토리를 참조하세요.

라이선스

MIT