🌤️ Cursor용 Weather MCP 서버 및 챗봇 인터페이스

Model Context Protocol (MCP) Weather 서버를 Cursor IDE에서 바로 사용할 수 있도록 구현하고, 날씨 에이전트와 대화하며 테스트할 수 있는 챗봇 웹 UI를 함께 제공하는 간단하고 완전한 Python 프로젝트입니다.

🌟 주요 기능

• 🌐 MCP 서버 (weather_mcp_server.py): stdio 전송 방식의 FastMCP로 구축되었습니다. Cursor 및 기타 MCP 클라이언트에 날씨 도구를 노출합니다.

• ⚡ 무료 실시간 날씨 (weather_service.py): Open-Meteo 기반으로 구동됩니다. API 키가 필요 없으며 전 세계 모든 도시에서 작동합니다.

• 🤖 날씨 에이전트 (agent.py): 자연어 질의("도쿄 날씨", "런던 5일 예보", "파리 대기질")를 도구 호출로 변환합니다.

• 💻 현대적인 챗봇 UI (static/ 및 app.py): 다크 모드, 글래스모픽 웹 인터페이스로 시각적 날씨 카드, 예보 테이블, 도구 실행 배지를 제공합니다.

• 🔌 Cursor 통합 (.cursor/mcp.json): Cursor 설정용 사전 구성된 JSON 파일입니다.

Related MCP server: weather-mcp-server

📁 프로젝트 구조

weather-mcp-chatbot/
│── .cursor/
│   └── mcp.json               # Cursor MCP configuration
│── weather_service.py         # Free Open-Meteo weather & geocoding integration
│── weather_mcp_server.py      # MCP Server (stdio transport for Cursor)
│── agent.py                   # Weather agent NLP & tool caller
│── app.py                     # FastAPI web server & chat endpoint
│── static/
│   ├── index.html             # Chatbot UI
│   ├── style.css              # Modern dark-mode styling
│   └── app.js                 # Chatbot frontend logic
│── test_mcp.py                # Automated test suite
│── requirements.txt           # Python dependencies
└── README.md                  # Documentation & quickstart

🚀 빠른 시작

1. 의존성 설치

pip install -r requirements.txt

2. 웹 챗봇 UI 실행

python app.py

브라우저를 열고 다음 주소로 이동하세요: http://127.0.0.1:8000

3. 자동화 테스트 실행

python test_mcp.py

🔌 Cursor에 연결하는 방법

Cursor는 Python MCP 서버에 직접 연결하여 Cursor Chat / Composer 내에서 실시간 날씨 데이터를 제공할 수 있습니다.

옵션 A: .cursor/mcp.json 사용 (권장)

1. Cursor에서 이 프로젝트 디렉터리를 엽니다:

   File -> Open Folder -> weather-mcp-chatbot

2. 프로젝트 내의 .cursor/mcp.json 파일은 Cursor가 자동으로 감지합니다.

옵션 B: Cursor 설정에서 추가

1. Cursor에서 설정(Ctrl + , 또는 Cmd + ,)을 엽니다.

2. Features -> MCP Servers로 이동합니다.

3. Add New MCP Server를 클릭합니다:

   • 이름: weather

   • 유형: command (stdio)

   • 명령어: python C:\Users\admin\.gemini\antigravity\scratch\weather-mcp-chatbot\weather_mcp_server.py

4. 저장을 클릭하고 녹색 상태 표시기를 확인합니다.

Cursor Chat에서 사용하기:

Cursor Composer 또는 Chat에서 이제 다음과 같이 질문할 수 있습니다:

• "도쿄의 현재 날씨는 어떤가요?"

• "@weather를 사용하여 베를린의 5일 예보를 확인해 주세요."

• "파리의 대기질은 어떤가요?"

Cursor가 MCP 도구(get_current_weather, get_weather_forecast, get_air_quality)를 호출하여 실시간 데이터를 가져옵니다!

🛠️ 노출되는 MCP 도구