공공 API 연동 MCP 샘플

Integra a API pública de clima da Administração Meteorológica da Coreia para fornecer dados climáticos.

Documentação

Amostra de MCP de Integração com API Pública

  • Este é um projeto de amostra do MCP (Model Context Protocol) que integra APIs públicas para receber respostas.

API Pública Utilizada

  • Foi utilizado o Serviço de Consulta de Clima Detalhado por Atração Turística por Rota Turística, fornecido pelo Centro Nacional de Dados Climáticos da Administração Meteorológica da Coreia. Para questões relacionadas à API, consulte a documentação da respectiva página.

  • A API retorna o índice TCI do ponto turístico com base no código da cidade e na data.

  • O código da cidade deve ser retornado por getCityInfo, mas nem todos os códigos foram incluídos.

  • Todos os códigos de cidade estão disponíveis em 지역코드.txt; consulte-os conforme necessário.

  • A chave da API deve ser solicitada no portal de dados públicos e adicionada em application.properties para uso.

Adição de Configuração (com base no Cursor)

  • Adicione o seguinte em mcp.json nas Configurações do Cursor.
{
  "mcpServers": {
    "weather-api": {
      "command": "java",
      "args": [
        "-Dspring.ai.mcp.server.transport=STDIO",
        "-jar",
        "jar 파일의 경로로 설정"
      ]
    }
  }
}
  • O teste de consulta foi realizado da seguinte forma. Exemplo: weather-api를 사용해서 제주도의 25년 7월 1일부터 5일간의 날씨를 알려 줘

Referência

  • Se o código for modificado, os seguintes procedimentos devem ser seguidos:
  1. Encerre o cliente, como o Cursor.
  2. Execute novamente o build com mvn clean package (se o processo estiver ocupado, encerre-o. A porta padrão é 8090).
  3. Reinicie o cliente e verifique se as ferramentas são carregadas corretamente.