MCP Java SDK — MCP 프로토콜

MCP·Skill / MCP 프로토콜 / java-sdk.html

Java로 MCP 서버·클라이언트를 만드는 공식 SDK

기본 정보

이 프로그램은 무엇인가?

Java 환경에서 MCP 서버를 만들려는 개발자를 위한 공식 SDK입니다. MCP의 핵심 프리미티브(도구·리소스·프롬프트)를 타입 안전하게 추상화합니다.

이 SDK는 Java 17 이상 환경에서 동작하며, stdio·Streamable HTTP 전송을 모두 지원합니다. 기존 Java 코드베이스에 MCP 기능을 자연스럽게 추가할 수 있습니다.

어떤 문제를 해결하는가?

• ('Java 프로젝트에서', 'MCP 서버·클라이언트를 구현해야 할 때', '공식 프리미티브로 프로토콜 준수 보장')
• ('타입 안전', '잘못된 프로토콜 사용을 컴파일 타임에 방지해야 할 때', '타입 시스템으로 실수 조기 발견')
• ('다중 전송', '로컬 stdio와 원격 HTTP를 모두 지원해야 할 때', '배포 환경에 맞는 전송 선택')

주요 기능

서버 구현

도구·리소스·프롬프트를 등록하는 서버 API

• 활용 상황: 외부 도구를 MCP로 노출
• 얻는 결과: 타입 안전한 서버 정의
• 제한 사항: 프로토콜 학습 필요

클라이언트 구현

MCP 서버에 연결하는 클라이언트 API

• 활용 상황: 에이전트에서 서버 호출
• 얻는 결과: 표준 프로토콜로 연결
• 제한 사항: 인증 설정 필요

전송 계층

stdio·Streamable HTTP 전송 내장

• 활용 상황: 로컬·원격 모두 지원
• 얻는 결과: 전송 교체 없이 배포
• 제한 사항: 원격 시 CORS·인증 필요

설치 및 실행

Maven:

Java 패키지 매니저로 설치합니다.

Maven: io.modelcontextprotocol.sdk:mcp

실제 사용 예제

서버 시작

mvn exec:java

MCP 서버를 stdio로 실행합니다.

장점과 한계

장점

• MCP 공식 프로젝트, 프로토콜 준수 보장
• Java 관용적 개발 패턴
• 다중 전송 지원

사용 전에 고려할 점

• Java 런타임 설치 필요
• 2026 사양 대응 시점은 SDK마다 차이

비슷한 프로그램과 비교

공식 자료 및 추가 학습

• 공식 홈페이지 — https://modelcontextprotocol.io/docs/sdk
• 공식 문서 / 지식베이스 — https://github.com/modelcontextprotocol/java-sdk-sdk
• 설치·배포 — Maven: io.modelcontextprotocol.sdk:mcp
• 릴리스 노트 — https://github.com/modelcontextprotocol/java-sdk-sdk/releases
• 소스 / 개발 자료 — https://github.com/modelcontextprotocol/java-sdk-sdk

버전·지원 환경 정보는 2026-10-18 기준으로 공식 사이트에서 확인한 값입니다. 설치 명령은 사용하는 배포판과 버전에 따라 달라질 수 있으므로 공식 설치 문서를 함께 확인하세요.

실제 실행 화면

합성 예시 — 실제 실행 결과가 아닙니다. 화면은 합성 예시이며 실제 실행 결과가 아닙니다.

실제 운영 중인 서버

이 문서는 화면 표시용 가상 디렉터리의 항목입니다. 실제 서버 파일시스템과 연결되지 않으며, 파일 실행이나 시스템 명령을 수행하지 않습니다.