공공 API 연동 MCP 샘플

Integrates the Korea Meteorological Administration's public weather API to provide climate data.

GitHub

공공 API 연동 MCP 샘플

  • 공공 API를 연동시켜 응답을 받는 MCP(Model Context Protocol)의 샘플 프로젝트이다.

사용된 공공 API

  • 기상청 국가기후 데이터센터에서 제공하는 관광코스별 관광지 상세 날씨 조회서비스 를 사용하였다. API 관련 사항은 해당 페이지의 문서를 참조하도록 한다.

  • 도시 코드와 날짜로 관광지 TCI 지수를 반환하도록 되어 있다

  • 도시 코드는 getCityInfo 에서 반환하도록 되어 있지만, 전부를 다 넣지는 않았다.

  • 모든 도시 코드는 지역코드.txt 에 있으므로 참고하도록 한다.

  • api 키는 공공데이터 포털에서 신청하여 받아 application.properties 에 추가하여 사용하도록 한다.

설정 추가 (커서 기준)

  • Cursor Setting 의 mcp.json 에 다음과 같이 추가해 준다.
{
  "mcpServers": {
    "weather-api": {
      "command": "java",
      "args": [
        "-Dspring.ai.mcp.server.transport=STDIO",
        "-jar",
        "jar 파일의 경로로 설정"
      ]
    }
  }
}
  • 질의 테스트는 다음과 같이 수행하였다. 예) weather-api를 사용해서 제주도의 25년 7월 1일부터 5일간의 날씨를 알려 줘

참고

  • 코드를 수정하였으면 다음 절차를 거쳐야 한다.
  1. 커서 등의 클라이언트 종료
  2. mvn clean package 로 빌드 재수행 (만약, 프로세스 점유 중이라면 종료한다. 디폴트 포트는 8090이다.)
  3. 클라이언트를 재시작해서 툴을 정상적으로 불러오나 확인

संबंधित सर्वर

NotebookLM Web Importer

एक क्लिक में वेब पेज और YouTube वीडियो NotebookLM में आयात करें। 200,000+ उपयोगकर्ताओं द्वारा विश्वसनीय।

Chrome एक्सटेंशन इंस्टॉल करें