MCP JSON-RPC 클라이언트 및 서버 예제

이 저장소에는 JavaScript로 구현된 MCP 기반 JSON‑RPC 클라이언트 및 서버의 간단하고 초보자 친화적인 예제가 포함되어 있습니다. 이 프로젝트는 외부 종속성 없이 Node.js 내장 모듈을 사용하는 기본적인 통신 흐름을 보여줍니다.

개요

• 서버( server.js ):
  • TCP 포트 4000에서 수신합니다.
  • 두 가지 JSON‑RPC 메서드를 구현합니다.
    • initialize : 기본 기능 객체를 반환합니다("에코" 도구를 광고함).
    • echo : 클라이언트가 제공한 매개변수를 에코로 반환합니다.
• 클라이언트( client.js ):
  • 포트 4000에서 서버에 연결합니다.
  • initialize 요청을 보낸 다음 echo 요청을 보냅니다.
  • 서버로부터 받은 응답을 기록합니다.

필수 조건

• 시스템에 Node.js가 설치되어 있어야 합니다(v10 이상을 권장합니다).

시작하기

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 MCP JSON-RPC 클라이언트 및 서버 예제를 자동으로 설치하려면 다음을 수행합니다.

지엑스피1

수동 설치

1. 저장소 복제:
   git clone https://github.com/sandy-mount/mcpjs.git cd mcp-jsonrpc-example
2. 서버를 실행합니다:터미널 창을 열고 다음을 실행합니다.
   node server.js
   다음과 같은 메시지가 표시됩니다.
   Server listening on port 4000
3. 클라이언트를 실행합니다:다른 터미널 창을 열고 다음을 실행합니다.
   node client.js
   클라이언트는 서버에 연결하여 초기화 및 에코 요청을 보내고 응답을 표시합니다.

작동 원리

• 서버는 포트 4000에서 들어오는 TCP 연결을 수신합니다. JSON‑RPC 메시지(각 메시지는 줄바꿈으로 끝남)를 수신하면 요청을 처리합니다.
  • initialize 메서드의 경우 기본 기능과 서버 정보가 포함된 JSON‑RPC 응답을 반환합니다.
  • echo 메서드의 경우 요청에서 전송된 매개변수를 반환합니다.
  • 알 수 없는 메서드를 요청하면 JSON‑RPC 오류로 응답합니다.
• 클라이언트는 서버에 연결하고 JSON‑RPC initialize 요청을 전송한 후 잠시 기다린 후 echo 요청을 전송합니다. 서버의 응답은 콘솔에 출력됩니다.

파일

• server.js — JSON‑RPC 서버 구현.
• client.js — JSON‑RPC 클라이언트 구현.

사용자 정의

이 예제를 다음과 같이 확장할 수 있습니다.

• 서버에 더 많은 JSON‑RPC 메서드를 추가합니다.
• 추가적인 오류 처리 및 로깅을 구현합니다.
• 다양한 전송 프로토콜을 실험하거나 TLS 지원을 추가합니다.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.

기여하다

자유롭게 이슈를 공개하거나 개선 사항이나 제안 사항이 있는 풀 리퀘스트를 제출하세요.

즐거운 코딩 되세요!