Weather MCP Tool
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Weather MCP Tool what's the weather in London?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Weather MCP Tool
Description
Weather MCP Tool là một ứng dụng NestJS cung cấp thông tin thời tiết thông qua Model Context Protocol (MCP). Ứng dụng sử dụng OpenWeatherMap API để lấy dữ liệu thời tiết thực tế cho các thành phố trên toàn thế giới.
Related MCP server: MCP Weather Data Fetcher
Tính năng
🌤️ Thông tin thời tiết thực tế: Lấy dữ liệu từ OpenWeatherMap API
🌍 Hỗ trợ đa ngôn ngữ: Mô tả thời tiết bằng tiếng Việt
📊 Thông tin chi tiết: Nhiệt độ, độ ẩm, tốc độ gió, nhiệt độ cảm giác
🔧 MCP Tool Integration: Tích hợp với Model Context Protocol
🚀 NestJS Framework: Xây dựng trên NestJS với TypeScript
🐳 Docker Support: Hỗ trợ chạy trong Docker container
Cài đặt
Cách 1: Cài đặt trực tiếp
# Clone repository
git clone <repository-url>
cd weather-mcp-nest
# Cài đặt dependencies
npm installCách 2: Sử dụng Docker
# Clone repository
git clone <repository-url>
cd weather-mcp-nest
# Build và chạy với Docker Compose
docker-compose up --buildCấu hình
Đăng ký OpenWeatherMap API:
Truy cập: https://openweathermap.org/api
Đăng ký tài khoản miễn phí
Lấy API key
Tạo file .env:
OPENWEATHER_API_KEY=your_api_key_here
Chạy ứng dụng
Development Mode
# Development mode
npm run start:dev
# Production mode
npm run start:prodDocker Mode
# Build Docker image
docker build -t weather-mcp .
# Chạy container
docker run -p 3000:3000 --env-file .env weather-mcp
# Hoặc sử dụng Docker Compose
docker-compose upSử dụng MCP Tool
Sau khi khởi động server, tool sẽ có sẵn thông qua MCP protocol:
Tool: getWeather
Mô tả: Lấy thông tin thời tiết cho một thành phố
Tham số:
city(string): Tên thành phố (VD: "Da Nang", "London", "New York")
Ví dụ sử dụng:
{
"name": "getWeather",
"arguments": {
"city": "Da Nang"
}
}Kết quả:
Thời tiết ở Da Nang: mây cụm, nhiệt độ 28°C (cảm giác như 33°C), độ ẩm 82%, gió 3.49 m/s.Cấu trúc dự án
src/
├── weather/
│ ├── weather.controller.ts # REST API controller
│ ├── weather.service.ts # Weather service logic
│ ├── weather.tool.ts # MCP tool implementation
│ └── weather.module.ts # Weather module
├── app.module.ts # Main application module
└── main.ts # Application entry pointAPI Endpoints
POST /weather
Lấy thông tin thời tiết qua REST API
Request Body:
{
"city": "Da Nang"
}Response:
{
"content": {
"type": "text",
"text": "Thời tiết ở Da Nang: mây cụm, nhiệt độ 28°C (cảm giác như 33°C), độ ẩm 82%, gió 3.49 m/s."
}
}MCP Configuration
Cấu hình MCP trong .cursor/mcp.json:
{
"mcpServers": {
"weather": {
"url": "http://localhost:3000/mcp",
"type": "http"
}
}
}Dependencies
@nestjs/common: NestJS core framework
@rekog/mcp-nest: MCP integration for NestJS
axios: HTTP client for API calls
dotenv: Environment variables management
zod: Schema validation
Phát triển
Chạy tests
# Unit tests
npm run test
# E2E tests
npm run test:e2e
# Test coverage
npm run test:covLinting
npm run lintDocker Commands
Build và chạy
# Build image
docker build -t weather-mcp .
# Chạy container
docker run -p 3000:3000 --env-file .env weather-mcp
# Chạy với Docker Compose
docker-compose up --buildQuản lý container
# Xem logs
docker-compose logs -f
# Dừng container
docker-compose down
# Restart container
docker-compose restartDevelopment với Docker
# Chạy trong development mode
docker-compose -f docker-compose.dev.yml upLicense
MIT License - xem file LICENSE để biết thêm chi tiết.
Available Tools
1 toolgetWeatherB
Get the weather for a city
Inputs: city (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only a single tool, there is no possibility of confusion or overlap. The tool's purpose is clearly defined by its name and description.
The single tool uses a consistent verb_noun pattern (get_weather). There are no other tools to introduce inconsistency.
One tool is on the low end but can be acceptable for a very narrow scope. However, a weather server typically warrants more than a single tool, so the count feels thin.
The tool only supports current weather for a city, but a complete weather domain would also include forecasts, historical data, or alerts. These missing operations represent significant gaps that would force agents to rely on external workarounds.
Maintenance
Related MCP Connectors
Unofficial OpenWeather MCP — wraps the OpenWeatherMap API (openweathermap.org)
Hosted MCP server for Xweather weather data: conditions, forecasts, alerts, and more.
MCP server for weather with reasoning — umbrella advice, outdoor checks, city comparisons.
Weather MCP — wraps Open-Meteo API (free, no auth)
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides real-time weather updates and city geocoding by integrating the Nominatim and Open-Meteo APIs. It enables users to retrieve current weather conditions for any location through natural language queries in MCP-compatible clients.ISC
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to retrieve live weather updates for any city via OpenWeatherMap, wrapped in MCP format.1ISC
- AlicenseNot gradedqualityBmaintenanceWraps the OpenWeatherMap API to provide weather data through MCP, enabling AI agents to query current conditions, forecasts, and other weather information via natural language.256 npmMIT
- AlicenseNot gradedqualityCmaintenanceProvides weather data from WeatherAPI.com through MCP, enabling AI agents to query current conditions and forecasts via natural language.146 npmMIT