public-data-mcp-server

constant94-dev/public-data-mcp-server

3.2

If you are the rightful owner of public-data-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

This document provides a comprehensive summary of a Model Context Protocol (MCP) server implementation using Java 21 and Gradle.

Tools
1
Resources
0
Prompts
0

Public Data MCP Server

MCP (Model Context Protocol) μ„œλ²„λ‘œ, AI 도ꡬ와 Spring Boot λ°±μ—”λ“œλ₯Ό μ—°κ²°ν•˜λŠ” 쀑간 계측 역할을 ν•©λ‹ˆλ‹€.

πŸš€ λΉ λ₯Έ μ‹œμž‘

μ‹€ν–‰ 방법

# κΈ°λ³Έ μ‹€ν–‰ (ν”„λ‘œλ•μ…˜ λͺ¨λ“œ)
./run-mcp-server.sh

# ν…ŒμŠ€νŠΈ λͺ¨λ“œ μ‹€ν–‰
./run-mcp-server.sh test

μ‚¬μš© κ°€λŠ₯ν•œ 도ꡬ

  • hello_world: μ‚¬μš©μž 인사 λ©”μ‹œμ§€ λ°˜ν™˜
  • spring_boot_health_check: Spring Boot μ„œλ²„ ν—¬μŠ€ 체크
  • get_user_info: μ‚¬μš©μž 정보 쑰회
  • get_session_info: μ„Έμ…˜ 정보 쑰회
  • get_public_data_info: 곡곡데이터 정보 쑰회
  • create_log: 둜그 기둝 생성

πŸ“ ν”„λ‘œμ νŠΈ ꡬ쑰

public-data-mcp-server/
β”œβ”€β”€ src/main/java/com/datapublic/mcp/
β”‚   β”œβ”€β”€ PublicDataMCPServer.java     # 메인 μ„œλ²„ 클래슀
β”‚   β”œβ”€β”€ client/
β”‚   β”‚   └── SpringBootApiClient.java # Spring Boot API ν΄λΌμ΄μ–ΈνŠΈ
β”‚   β”œβ”€β”€ controller/
β”‚   β”‚   └── MCPServerController.java # MCP 컨트둀러
β”‚   └── service/
β”‚       β”œβ”€β”€ HelloService.java        # Hello World μ„œλΉ„μŠ€
β”‚       └── SpringBootIntegrationService.java # Spring Boot 연동 μ„œλΉ„μŠ€
β”œβ”€β”€ logs/                           # 둜그 파일
β”œβ”€β”€ run-mcp-server.sh               # 톡합 μ‹€ν–‰ 슀크립트
β”œβ”€β”€ build.gradle                    # λΉŒλ“œ μ„€μ •
└── README.md                       # 이 파일

πŸ”§ ν™˜κ²½ μ„€μ •

ν™˜κ²½λ³€μˆ˜

μ›Œν¬μŠ€νŽ˜μ΄μŠ€ 루트의 .env/.secrets.env νŒŒμΌμ—μ„œ ν™˜κ²½λ³€μˆ˜λ₯Ό μ„€μ •ν•  수 μžˆμŠ΅λ‹ˆλ‹€:

# Spring Boot λ°±μ—”λ“œ URL
SPRING_BOOT_URL=http://localhost:8080

# νƒ€μž„μ•„μ›ƒ μ„€μ • (초)
SPRING_BOOT_TIMEOUT=10

둜그 관리

  • 둜그 νŒŒμΌμ€ logs/ 폴더에 μ €μž₯λ©λ‹ˆλ‹€
  • 파일λͺ… ν˜•μ‹: mcp-server-YYYYMMDD_HHMMSS.log
  • PID νŒŒμΌμ€ μƒμ„±λ˜μ§€ μ•ŠμŠ΅λ‹ˆλ‹€

πŸ› οΈ 개발

λΉŒλ“œ

./gradlew clean build

ν…ŒμŠ€νŠΈ

./gradlew test

μ‹€ν–‰

# 개발 λͺ¨λ“œ
./gradlew run

# ν”„λ‘œλ•μ…˜ λͺ¨λ“œ
./run-mcp-server.sh

πŸ”— κ΄€λ ¨ ν”„λ‘œμ νŠΈ

πŸ“ μ—…λ°μ΄νŠΈ νžˆμŠ€ν† λ¦¬

2025-08-24

  • βœ… 슀크립트 톡합: 3개의 슀크립트λ₯Ό 1개둜 톡합
  • βœ… PID 파일 제거: PID 파일 생성 둜직 제거
  • βœ… 둜그 관리 κ°œμ„ : logs 폴더에 둜그 파일 μ €μž₯
  • βœ… ν”„λ‘œμ νŠΈλͺ… 톡일: JAR 파일λͺ…을 ν”„λ‘œμ νŠΈλͺ…에 맞게 μˆ˜μ •

2025-08-17

  • βœ… MCP Java SDK 기반 μ„œλ²„ κ΅¬ν˜„: PublicDataMCPServer.java
  • βœ… Hello World 도ꡬ κ΅¬ν˜„: μ‚¬μš©μž 인사 λ©”μ‹œμ§€ λ°˜ν™˜
  • βœ… STDIO 전솑 ν”„λ‘œν† μ½œ: ν‘œμ€€ μž…μΆœλ ₯ 톡신 κ΅¬ν˜„
  • βœ… JSON-RPC 2.0 ν”„λ‘œν† μ½œ: MCP ν‘œμ€€ ν”„λ‘œν† μ½œ 지원
  • βœ… Docker μ»¨ν…Œμ΄λ„ˆ 지원: μ»¨ν…Œμ΄λ„ˆ 기반 μ‹€ν–‰ ν™˜κ²½
  • βœ… Spring Boot API ν΄λΌμ΄μ–ΈνŠΈ κ΅¬ν˜„: WebClient 기반 REST API ν΄λΌμ΄μ–ΈνŠΈ
  • βœ… Spring Boot 톡합 MCP 도ꡬ κ΅¬ν˜„: 6개 도ꡬ μ™„μ„±
  • βœ… ν™˜κ²½λ³€μˆ˜ μ„€μ • ν™•μž₯: μ›Œν¬μŠ€νŽ˜μ΄μŠ€ 루트 .env 디렉토리 ν™œμš©
  • βœ… μ—λŸ¬ 처리 및 λ‘œκΉ…: μƒμ„Έν•œ μ—λŸ¬ 처리 및 λ‘œκΉ… μ‹œμŠ€ν…œ

λ§ˆμ§€λ§‰ μ—…λ°μ΄νŠΈ: 2025-08-24
μž‘μ„±μž: Ethan
μƒνƒœ: 슀크립트 톡합 및 둜그 관리 κ°œμ„  μ™„λ£Œ βœ