MCP Weather Server

MCP Weather Server

Provides real-time weather information and 5-day forecasts for cities worldwide using the OpenWeatherMap API. Supports bilingual queries (Chinese and English) with comprehensive weather data including temperature, humidity, and wind speed.

Category
Visit Server

README

MCP Weather Server

這是一個基於Model Context Protocol (MCP)的天氣資訊服務器,使用OpenWeatherMap API提供即時天氣資訊和天氣預報功能。

功能特點

  • 獲取城市當前天氣資訊
  • 獲取城市5天天氣預報
  • 支持中英文城市名稱查詢
  • 完整的錯誤處理機制
  • 豐富的天氣資訊顯示(溫度、濕度、風速等)

系統要求

  • Python >= 3.10
  • OpenWeatherMap API金鑰

安裝

  1. 確保您已安裝 Python 3.10 或更高版本
  2. 使用以下命令安裝依賴套件:
uv venv
uv pip install -r requirements.txt

配置

mcp.json 中配置您的OpenWeatherMap API金鑰:

{
  "mcpServers": {
    "weather": {
      "command": "uv",
      "args": ["--directory", ".", "run", "main.py"],
      "description": "天氣資訊伺服器 - 取得當前天氣和天氣預報",
      "env": {
        "OPENWEATHER_API_KEY": "your_api_key_here"
      }
    }
  }
}

使用方法

作為MCP服務器運行

python main.py

使用客戶端

python client.py

API參考

獲取當前天氣

get_current_weather(city: str) -> str
  • 參數:
    • city: 城市名稱(支持中英文)
  • 返回:格式化的當前天氣資訊

獲取天氣預報

get_weather_forecast(city: str, days: int = 5) -> str
  • 參數:
    • city: 城市名稱(支持中英文)
    • days: 預報天數(1-5天,預設5天)
  • 返回:格式化的天氣預報資訊

資源端點

  • weather://current/{city} - 獲取指定城市的當前天氣資源
  • weather://forecast/{city} - 獲取指定城市的天氣預報資源
  • weather://api-status - 獲取API狀態資訊

授權

MIT License

貢獻

歡迎提交問題和拉取請求!

致謝

部署

關於部署的詳細信息,請參考 部署指南

支持的部署方式:

  • 直接部署(Python 環境)
  • Docker 部署
  • Docker Compose 部署
  • 系統服務部署(Linux)

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured