mcpField
天
天气 MCP 服务器

天气 MCP 服务器

ローカル
github.com/qianyanメディア・デザイン082 週間前に更新
リポジトリ

天气 MCP 服务器 について

FastMCPで構築された天気情報のMCPサーバーです。自然言語で都市の天気を調べたいユーザー向けで、世界の都市に対応し、摂氏と華氏を切り替えられます。

主な機能

  1. 01世界の都市の天気を検索
  2. 02気温・湿度・天気の説明を返却
  3. 03摂氏と華氏に対応
  4. 04実行ログの記録

活用シーン

  1. 01北京の現在の天気を確認
  2. 02単位を指定して東京の気温を取得
  3. 03ロンドンの湿度と天気の説明を確認

MCP 対応

都市名と温度単位を指定して天気を調べる get_weather ツールをMCPクライアントに公開します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "weather-mcp-server-qianyan": {
      "command": "uvx",
      "args": [
        "weather-mcp-server"
      ],
      "env": {
        "OPENWEATHER_API_KEY": "<OPENWEATHER_API_KEY>"
      }
    }
  }
}
起動コマンドuvx weather-mcp-server
設定が必要な環境変数
OPENWEATHER_API_KEYシークレット

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
pypiweather-mcp-server

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

プロジェクトの README より

天气 MCP 服务器

这是一个基于 FastMCP 构建的天气查询服务器，提供城市天气信息查询服务。

功能特点

  • 支持全球城市天气查询
  • 提供温度、湿度和天气描述信息
  • 支持摄氏度和华氏度温度单位切换
  • 基于 Model Context Protocol (MCP) 实现
  • 完整的日志记录

安装要求

  • Python 3.8+
  • OpenWeatherMap API 密钥
  • uv (Python 包管理工具)

快速开始

  1. 克隆仓库：
git clone <repository-url>
cd weather-mcp-server
  1. 安装依赖：
make install
  1. 设置环境变量： 创建 .env 文件并添加以下内容：
OPENWEATHER_API_KEY=你的OpenWeatherMap_API密钥
  1. 运行服务器：
make run

安装和使用

选项 1：使用 uvx（推荐）

使用 uvx 将自动从 PyPI 安装包，无需克隆仓库。将以下配置添加到 Claude Desktop 的配置文件 claude_desktop_config.json 中：

{
  "mcpServers": {
    "weather-mcp-server": {
      "command": "uvx",
      "args": [
        "weather-mcp-server"
      ],
      "env": {
        "OPENWEATHER_API_KEY": "你的OpenWeatherMap_API密钥"
      }
    }
  }
}
选项 2：本地开发模式
  1. 克隆仓库并安装依赖：
git clone <repository-url>
cd weather-mcp-server
make install
  1. 设置环境变量： 创建 .env 文件并添加以下内容：
OPENWEATHER_API_KEY=你的OpenWeatherMap_API密钥
  1. 在 Claude Desktop 配置文件中添加：
{
  "mcpServers": {
    "weather": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/src/weather_mcp_server",
        "run",
        "weather-mcp-server"
      ],
      "env": {
        "OPENWEATHER_API_KEY": "你的OpenWeatherMap_API密钥"
      }
    }
  }
}

配置文件位置：

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%/Claude/claude_desktop_config.json

重启 Claude Desktop 以加载新的 MCP 服务器。

开发

本项目使用 Makefile 来简化常用命令。

可用命令
make install  # 安装依赖
make format   # 格式化代码
make lint     # 运行代码检查
make clean    # 清理临时文件
make run      # 运行服务器
发布新版本
make release version=v0.1.0

MCP 工具

服务器提供以下 MCP 工具：

get_weather

获取指定城市的天气信息。

参数：

  • city: 城市名称（必填）
  • units: 温度单位（可选，默认为 "metric"）
    • "metric": 摄氏度
    • "imperial": 华氏度

示例请求：

{
    "name": "get_weather",
    "kwargs": {
        "city": "Beijing",
        "units": "metric"
    }
}

示例响应：

{
    "temperature": 20.5,
    "humidity": 65,
    "description": "晴",
    "city": "Beijing"
}

现在您可以通过 Claude 使用自然语言命令与天气服务进行交互，例如：

  • "查看北京的天气"
  • "东京现在的温度是多少"
  • "伦敦的天气情况如何"

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。