JWeather

JWeather

juhemcp

Provides real-time weather data and forecasts through a Python-based MCP server that integrates with weather APIs.

Integrates with weather data services to provide real-time conditions and forecasts through an asyncio-powered Python server with automated CI/CD workflows.

218 views5Local (stdio)

What it does

  • Fetch current weather conditions
  • Get weather forecasts
  • Query weather data by location
  • Access real-time meteorological information

Best for

Developers building weather-aware applicationsAutomating weather-based workflowsAdding weather context to AI assistants
Asyncio-powered for performanceAutomated CI/CD workflows

About JWeather

JWeather is a community-built MCP server published by juhemcp that provides AI assistants with tools and capabilities via the Model Context Protocol. JWeather offers real-time conditions & forecasts via an asyncio Python server, integrating with top weather services. Au It is categorized under developer tools.

How to install

You can install JWeather in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.

License

JWeather is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.

Juhe Weather MCP Server

一个提供全国天气预报查询功能的模型上下文协议(Model Context Protocol)服务器。该服务器使大型语言模型(LLMs)能够获取全国城市、地区的天气预报情况。

Components

Tools

服务器实现了一个工具:

  • query_weather: 根据城市、地区、区县名称查询当地实时天气预报情况.
    • 需要传入 "city"(城市、区县等名称)作为必须的字符串参数。
async def query_weather(
    city: str = Field(description="查询的城市名称,如北京、上海、广州、深圳、泰顺等;城市或区县或地区名使用简写,严格按照规范填写,否则会导致查询失败")
) -> list[types.TextContent | types.ImageContent | types.EmbeddedResource]:

Install

This server requires Python 3.10 or higher. Install dependencies using uv (recommended) or pip

Using uv (recommended)

When using uv no specific installation is needed. We will use uvx to directly run jweather-mcp-server.

uvx jweather-mcp-server

Using PIP

Alternatively you can install jweather-mcp-server via pip:

pip install jweather-mcp-server

After installation, you can run it as a script using:

python -m jweather_mcp_server

Configuration

Environment Variables

JUHE_WEATHER_API_KEY: 聚合数据的天气预报查询API密钥。获取:https://www.juhe.cn/docs/api/id/73

JUHE_WEATHER_API_KEY=your_api_key

Configure For CLINE

Using uvx
"mcpServers": {
  "jweather-mcp-server": {
    "command": "uvx",
    "args": [
      "jweather-mcp-server"
    ],
    "env": {
      "JUHE_WEATHER_API_KEY": "your_api_key"
    }
  }
}
Using pip installation
"mcpServers": {
  "jweather-mcp-server": {
    "command": "python",
    "args": [
      "-m",
      "jmobile_location_mcp_server"
    ],
    "env": {
      "JUHE_WEATHER_API_KEY": "your_api_key"
    }
  }
}

Debugging

You can use the MCP inspector to debug the server. For uvx installations:

npx @modelcontextprotocol/inspector uvx jweather-mcp-server 

Or if you've installed the package in a specific directory or are developing on it:

cd path/to/servers/src/jweather-mcp-server
npx @modelcontextprotocol/inspector uv run jweather-mcp-server

Examples of Questions for Cline

  1. "查询下苏州的天气"
  2. "今天上海的天气如何?"

Alternatives

Related Skills

Browse all skills
ui-design-system

UI design system toolkit for Senior UI Designer including design token generation, component documentation, responsive design calculations, and developer handoff tools. Use for creating design systems, maintaining visual consistency, and facilitating design-dev collaboration.

6
cli-builder

Guide for building TypeScript CLIs with Bun. Use when creating command-line tools, adding subcommands to existing CLIs, or building developer tooling. Covers argument parsing, subcommand patterns, output formatting, and distribution.

2
openai-knowledge

Use when working with the OpenAI API (Responses API) or OpenAI platform features (tools, streaming, Realtime API, auth, models, rate limits, MCP) and you need authoritative, up-to-date documentation (schemas, examples, limits, edge cases). Prefer the OpenAI Developer Documentation MCP server tools when available; otherwise guide the user to enable `openaiDeveloperDocs`.

0
api-documenter

Master API documentation with OpenAPI 3.1, AI-powered tools, and modern developer experience practices. Create interactive docs, generate SDKs, and build comprehensive developer portals. Use PROACTIVELY for API documentation or developer portal creation.

0
ydc-ai-sdk-integration

Integrate Vercel AI SDK applications with You.com tools (web search, AI agent, content extraction). Use when developer mentions AI SDK, Vercel AI SDK, generateText, streamText, or You.com integration with AI SDK.

0
mcp-developer

Use when building MCP servers or clients that connect AI systems with external tools and data sources. Invoke for MCP protocol compliance, TypeScript/Python SDKs, resource providers, tool functions.

0