Cline과 MCP를 이용한 날씨 도구 호출

LLM이 실제 날씨 데이터를 가져올 수 있게 해주는 작은 Python MCP 서버입니다.

사용자가 Cline에서 날씨 질문을 하면, LLM은 날씨 도구를 호출할지 결정하고 필요한 인자를 생성해 이 서버로 요청을 보냅니다. 서버는 미국 국립기상청(NWS)에서 데이터를 가져오며, LLM은 그 결과를 이용해 최종 답변을 작성합니다.

작동 원리

User question
    -> Cline sends the question and tool definitions to the LLM
    -> The LLM selects a weather tool and generates its arguments
    -> Cline calls the Python MCP server
    -> The server fetches real data from api.weather.gov
    -> The LLM turns the tool result into a natural-language answer

Related MCP server: Weather MCP Server

기술 스택

• Python 3.14

• MCP Python SDK

• Cline (MCP 클라이언트 및 LLM 호스트)

• 데모용 DeepSeek 모델을 사용하는 OpenRouter

• HTTPX

• 미국 국립기상청 API

• uv

도구

get_forecast

미국의 한 위치에 대한 다음 5개 예보 기간을 가져옵니다.

{
  "latitude": 40.7128,
  "longitude": -74.006
}

get_alerts

미국의 한 주에 대한 현재 기상 특보를 가져옵니다.

{
  "state": "NY"
}

설정

요구 사항:

• Python 3.14

• uv

• Cline이 설치된 Visual Studio Code

• Cline에 설정된 도구 호출 가능한 LLM용 API 키

프로젝트 설치:

git clone <https://github.com/yang648557392/weather-mcp-tool-calling.git>
cd weather
uv sync

MCP 서버를 Cline의 MCP 설정에 추가하세요. 경로는 이 프로젝트의 절대 경로로 바꿔 주세요:

{
  "mcpServers": {
    "weather": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/weather", "run", "weather.py"],
      "disabled": false
    }
  }
}

Cline에서 MCP 서버를 재시작하면 Cline이 get_forecast와 get_alerts를 자동으로 발견합니다.

Cline이 uv를 찾지 못한다면, 다음 명령이 반환한 절대 경로로 "uv"를 대체하세요:

which uv

사용 방법

Cline에 다음과 같은 질문을 해보세요:

What will the weather be like in New York tomorrow?
Are there any active weather alerts in California?

Cline은 선택된 도구, 그 도구의 인자, 도구 결과, 그리고 LLM의 최종 응답을 보여줍니다.

제한 사항

• NWS API는 미국 국립기상청이 서비스하는 지역의 위치에서만 지원됩니다.

• LLM은 위치 이름을 좌표로 변환하는 책임이 있습니다.

• LLM 호스트 및 MCP 클라이언트로 Cline이 필요합니다.

• 공급자 API 키는 Cline에 저장되며 이 저장소에 커밋해서는 안 됩니다.

저자

Mingzhe Yang