공공 API 연동 MCP 샘플

Integra la API pública de clima de la Administración Meteorológica de Corea para proporcionar datos climáticos.

Documentación

공공 API 연동 MCP 샘플

  • Es un proyecto de muestra de MCP (Model Context Protocol) que se integra con API públicas para recibir respuestas.

API pública utilizada

  • Se utilizó el Servicio de consulta de clima detallado por destino turístico según curso turístico proporcionado por el Centro Nacional de Datos Climáticos de la Administración Meteorológica de Corea. Para asuntos relacionados con la API, consulte la documentación de esa página.

  • Está diseñado para devolver el índice TCI del destino turístico según el código de ciudad y la fecha.

  • El código de ciudad está diseñado para devolverse desde getCityInfo, pero no se incluyeron todos.

  • Todos los códigos de ciudad están en 지역코드.txt, así que consúltelos.

  • La clave API se solicita y recibe en el portal de datos públicos, y debe agregarse a application.properties para su uso.

Adición de configuración (basado en Cursor)

  • Agregue lo siguiente a mcp.json de la Configuración de Cursor.
{
  "mcpServers": {
    "weather-api": {
      "command": "java",
      "args": [
        "-Dspring.ai.mcp.server.transport=STDIO",
        "-jar",
        "jar 파일의 경로로 설정"
      ]
    }
  }
}
  • La prueba de consulta se realizó de la siguiente manera. Ej.) weather-api를 사용해서 제주도의 25년 7월 1일부터 5일간의 날씨를 알려 줘

Referencia

  • Si modificó el código, debe seguir el siguiente procedimiento.
  1. Cierre el cliente, como Cursor.
  2. Vuelva a ejecutar la compilación con mvn clean package (si el proceso está ocupado, ciérrelo. El puerto predeterminado es 8090).
  3. Reinicie el cliente y verifique que las herramientas se carguen correctamente.