Skip to main content
Glama
X-JS

weather_mcp

by X-JS
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

项目预览

mcp_weather_demo — 基于 uv 管理环境的 MCP (Model Context Protocol) 天气服务端，提供三种运行方式：

  • 纯 stdio / JSON-RPC 2.0 实现（main.py）

  • FastMCP 官方库实现（weather_mcp_fastmcp.py）

  • FastMCP Streamable HTTP 传输（weather_mcp_http.py）

通过免费天气 API 查询实时天气，以 MCP Tool 形式暴露 get_current_weather 接口。

Related MCP server: ai-mcp

项目结构

mcp-weather-demo/
├── src/
│   └── mcp_weather_demo/
│       ├── __init__.py              # 包入口
│       ├── main.py                  # 纯 JSON-RPC / stdio 实现
│       ├── weather_mcp_fastmcp.py   # FastMCP 官方库实现（stdio）
│       └── weather_mcp_http.py      # FastMCP Streamable HTTP 实现
├── pyproject.toml                   # uv 项目元信息与依赖声明（Python >= 3.13, fastmcp, httpx）
├── uv.lock                          # uv 依赖锁定
├── requirements.txt                 # pip 依赖（可选，兼容其他环境）
├── logs/                            # main.py 运行日志
└── .venv/                           # uv 管理的虚拟环境

技术栈

  • 语言: Python >= 3.13（使用 dict | None 联合类型语法）

  • 依赖管理: uv

  • HTTP 客户端: httpx

  • MCP 框架: fastmcp（官方库）

  • 协议: MCP (JSON-RPC 2.0) over stdio / Streamable HTTP

Setup & Development

使用 uv 管理项目环境：

# 安装依赖并同步环境（首次运行，会自动创建 .venv）
uv sync

运行方式

项目在 pyproject.toml 中声明了多个脚本入口：

# 纯 JSON-RPC / stdio 服务端（等待 stdin 的 JSON-RPC 消息）
uv run mcp-weather-stdio

# FastMCP 官方库，stdio 传输
uv run fastmcp-stdio

# FastMCP Streamable HTTP 传输，默认 http://0.0.0.0:8000/mcp
uv run fastmcp-http

MCP 协议支持

方法

说明

initialize

握手，返回 server capabilities

notifications/initialized

客户端初始化完成通知

ping

心跳检测

tools/list

列出可用工具（get_current_weather）

tools/call

调用天气查询工具

测试方式

使用任意 MCP 客户端连接，或通过 echo/管道发送 JSON-RPC 消息测试：

# stdio 服务
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | uv run mcp-weather-stdio

# HTTP 服务
uv run fastmcp-http   # 然后连接 http://0.0.0.0:8000/mcp

Available Tools

1 tool
get_current_weatherGet Current WeatherA

查询指定城市的当前天气。支持英文城市名，返回中文天气信息。

ParametersJSON Schema
NameRequiredDescriptionDefault
cityYes城市英文名，例如 Nanhai（南海）、Foshan（佛山）
stateNo省/州英文名，例如 Guangdong（广东）
countryNo国家英文名，例如 China

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It adds useful behavioral facts — '支持英文城市名' (English city names supported) and '返回中文天气信息' (Chinese weather output) — and '查询' implies a read-only operation. However, it does not disclose potential error conditions, units, data-source limitations, or response details beyond the existence of an output schema.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two short sentences with zero filler: the core action comes first, followed by the two most actionable operational facts (input language and output language). Every word earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple weather-query tool with only one required parameter, a terse description is adequate because the schema documents all parameters and an output schema exists. The only missing context is optional details like units or failure behavior, which are not essential for selecting and invoking the tool correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, and each parameter (city, state, country) is already described with examples and defaults. The tool description adds no parameter-specific semantics beyond what the schema already provides, so the baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description begins with '查询指定城市的当前天气' — a specific verb ('query') and resource ('current weather for specified city') — and adds concrete constraints (English city names, Chinese output). With no sibling tools present, there is no differentiation burden, and an agent can identify the tool's function immediately.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description states a clear use context: retrieving the current weather for a specified city, with input language and output language expectations. There are no siblings or alternatives to exclude, so the lack of explicit 'when not to use' is not a meaningful gap.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 1 tool updatev0.1.0
    • First observedget_current_weather
Install Server
RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

TDQS

A3.9/5.0
Disambiguation5/5

With only a single tool, there is no possibility of confusion or overlap. The purpose of get_current_weather is unambiguous.

Naming Consistency5/5

The tool name follows a clear verb_noun pattern (get_current_weather). Even as a lone tool, it is consistent and predictable.

Tool Count2/5

A weather server with only one tool is too sparse. Users would reasonably expect at least forecasts or additional conditions, so the count feels insufficient for the apparent scope.

Completeness2/5

The server only provides current weather, leaving out forecasts, historical data, or other typical weather queries. This creates a significant gap for any practical weather-related workflow.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • ai-mcp

    wangyj641
    F
    license
    A
    quality
    D
    maintenance
    Lightweight MCP server that exposes tools for system information and weather lookup, designed for agent integration via stdio.
    1
    -

  • weather-mcp

    ninemindai
    A
    license
    Not graded
    quality
    B
    maintenance
    Exposes weather data from the free Open-Meteo API via decorator-driven MCP tools with Zod schemas, supporting stdio and HTTP transports.
    28
    MIT

  • my-weather-server-0706

    yangvue
    A
    license
    A
    quality
    B
    maintenance
    MCP server that provides current weather for any city using Open-Meteo APIs. It exposes a single tool 'get_weather' returning temperature, humidity, wind, and other weather data.
    1
    16
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/X-JS/mcp-weather-demo'

If you have feedback or need assistance with the MCP directory API, please join our Discord server