Weather MCP Server Demo
Một MCP Server đơn giản sử dụng Python và FastMCP để tra cứu thông tin thời tiết từ OpenWeatherMap.
Yêu cầu
- Python 3.10+
- OpenWeatherMap API Key (miễn phí)
Hướng dẫn cài đặt
-
Cài đặt dependencies:
bash pip install -r requirements.txt -
Cấu hình API Key:
- Tạo file.envtừ file mẫu:bash cp .env.example .env
- Mở file.envvà dán API key của bạn vào:OPENWEATHER_API_KEY=your_actual_api_key_here
Hướng dẫn chạy
Cách 1: Test bằng MCP Inspector
MCP Inspector là công cụ visual giúp test server dễ dàng trên trình duyệt.
- Chạy Inspector:
Mở terminal tại thư mục project và chạy:bash npx @modelcontextprotocol/inspector python weather_server.py
Lần đầu chạy có thể sẽ cần xác nhận cài đặt gói npx.
- Sử dụng giao diện Web:
- Inspector sẽ tự động mở một đường dẫn (thường làhttp://localhost:5173) trên trình duyệt.
- Nhìn sang panel bên trái sẽ thấy trạng thái Connected.
- Chọn tab Tools.
- Bạn sẽ thấy danh sách tools:get_current_weather,get_weather_forecast.
- Chọn một tool (ví dụget_current_weather), nhập tham sốcity(ví dụ: "Hanoi") vào form.
- Nhấn nút Run Tool.
- Kết quả trả về từ API sẽ hiện ở khung bên phải (Result).
Cách 2: Tích hợp với Claude Desktop
Thêm configuration sau vào file claude_desktop_config.json:json
{
"mcpServers": {
"weather-demo": {
"command": "python",
"args": ["/path/to/MCP_Demo/weather_server.py"]
}
}
}
Lưu ý: Thay /path/to/MCP_Demo/weather_server.py bằng đường dẫn tuyệt đối đến file code.
Các Tools có sẵn
get_current_weather(city): Xem thời tiết hiện tại.get_weather_forecast(city): Xem dự báo 5 ngày tới.
