JWeather

by juhemcp

1.3k downloads

Not rated

GitHub

About

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

Details

Author: juhemcp
Repository: juhemcp/jweather-mcp-server
Downloads: 1,286
Categories: Productivity, Design, Developer Tools, AI, Infrastructure, Automation, Media

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name JWeather

Command (node, npx, python, etc.) uvx
Arguments
- Argument 1 jweather-mcp-server
Environment
- JUHE_WEATHER_API_KEY your_api_key
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "jweather": {
            "env": {
                "JUHE_WEATHER_API_KEY": "your_api_key"
            },
            "args": [
                "jweather-mcp-server"
            ],
            "command": "uvx"
        }
    }
}

JSON

{
    "mcpServers": {
        "jweather": {
            "env": {
                "JUHE_WEATHER_API_KEY": "your_api_key"
            },
            "args": [
                "jweather-mcp-server"
            ],
            "command": "uvx"
        }
    }
}

JSON

{
    "mcpServers": {
        "jweather": {
            "env": {
                "JUHE_WEATHER_API_KEY": "your_api_key"
            },
            "args": [
                "jweather-mcp-server"
            ],
            "command": "uvx"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "jweather": {
            "env": {
                "JUHE_WEATHER_API_KEY": "your_api_key"
            },
            "args": [
                "jweather-mcp-server"
            ],
            "command": "uvx"
        }
    }
}

JSON

{
    "mcpServers": {
        "jweather": {
            "env": {
                "JUHE_WEATHER_API_KEY": "your_api_key"
            },
            "args": [
                "jweather-mcp-server"
            ],
            "command": "uvx"
        }
    }
}

JSON

{
    "mcpServers": {
        "jweather": {
            "env": {
                "JUHE_WEATHER_API_KEY": "your_api_key"
            },
            "args": [
                "jweather-mcp-server"
            ],
            "command": "uvx"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "jweather": {
            "env": {
                "JUHE_WEATHER_API_KEY": "your_api_key"
            },
            "args": [
                "jweather-mcp-server"
            ],
            "command": "uvx"
        }
    }
}

JSON

{
    "mcpServers": {
        "jweather": {
            "env": {
                "JUHE_WEATHER_API_KEY": "your_api_key"
            },
            "args": [
                "jweather-mcp-server"
            ],
            "command": "uvx"
        }
    }
}

JSON

{
    "mcpServers": {
        "jweather": {
            "env": {
                "JUHE_WEATHER_API_KEY": "your_api_key"
            },
            "args": [
                "jweather-mcp-server"
            ],
            "command": "uvx"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "jweather": {
            "env": {
                "JUHE_WEATHER_API_KEY": "your_api_key"
            },
            "args": [
                "jweather-mcp-server"
            ],
            "command": "uvx"
        }
    }
}

JSON

{
    "mcpServers": {
        "jweather": {
            "env": {
                "JUHE_WEATHER_API_KEY": "your_api_key"
            },
            "args": [
                "jweather-mcp-server"
            ],
            "command": "uvx"
        }
    }
}

JSON

{
    "mcpServers": {
        "jweather": {
            "env": {
                "JUHE_WEATHER_API_KEY": "your_api_key"
            },
            "args": [
                "jweather-mcp-server"
            ],
            "command": "uvx"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "jweather": {
            "env": {
                "JUHE_WEATHER_API_KEY": "your_api_key"
            },
            "args": [
                "jweather-mcp-server"
            ],
            "command": "uvx"
        }
    }
}

JSON

{
    "mcpServers": {
        "jweather": {
            "env": {
                "JUHE_WEATHER_API_KEY": "your_api_key"
            },
            "args": [
                "jweather-mcp-server"
            ],
            "command": "uvx"
        }
    }
}

JSON

{
    "mcpServers": {
        "jweather": {
            "env": {
                "JUHE_WEATHER_API_KEY": "your_api_key"
            },
            "args": [
                "jweather-mcp-server"
            ],
            "command": "uvx"
        }
    }
}

From the repository

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

JUHE_WEATHER_API_KEY=your_api_key

<details>
<summary>Using uvx</summary>

  "mcpServers": {
    "jweather-mcp-server": {
      "command": "uvx",
      "args": [
        "jweather-mcp-server"
      ],
      "env": {
        "JUHE_WEATHER_API_KEY": "your_api_key"
      }
    }
  }

</details>

<details>
<summary>Using pip installation</summary>

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

</details>

`query_weather`

根据城市、地区、区县名称查询当地实时天气预报情况. 需要传入 'city'（城市、区县等名称）作为必须的字符串参数。

服务器实现了一个工具:

- query_weather: 根据城市、地区、区县名称查询当地实时天气预报情况.
- 需要传入 "city"（城市、区县等名称）作为必须的字符串参数。

async def query_weather(

    city: str = Field(description="查询的城市名称，如北京、上海、广州、深圳、泰顺等；城市或区县或地区名使用简写，严格按照规范填写，否则会导致查询失败")

) -> list[types.TextContent | types.ImageContent | types.EmbeddedResource]:

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "jweather": {
            "env": {
                "JUHE_WEATHER_API_KEY": "your_api_key"
            },
            "args": [
                "jweather-mcp-server"
            ],
            "command": "uvx"
        }
    }
}

Linux

{
    "env": {
        "JUHE_WEATHER_API_KEY": "your_api_key"
    },
    "args": [
        "jweather-mcp-server"
    ],
    "command": "uvx"
}

Macos

{
    "env": {
        "JUHE_WEATHER_API_KEY": "your_api_key"
    },
    "args": [
        "jweather-mcp-server"
    ],
    "command": "uvx"
}

Windows

{
    "env": {
        "JUHE_WEATHER_API_KEY": "your_api_key"
    },
    "args": [
        "jweather-mcp-server"
    ],
    "command": "uvx"
}

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

<details>
<summary>Using uvx</summary>

  "mcpServers": {
    "jweather-mcp-server": {
      "command": "uvx",
      "args": [
        "jweather-mcp-server"
      ],
      "env": {
        "JUHE_WEATHER_API_KEY": "your_api_key"
      }
    }
  }

</details>

<details>
<summary>Using pip installation</summary>

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

</details>

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. "今天上海的天气如何？"29:["$","div",null,{"className":"my-8 pb-8 h-full max-w-5xl mx-auto","children":["$","div",null,{"className":"grid grid-cols-1 md:grid-cols-3 gap-6","children":["$","$L30",null,{"mcp":{"id":"mcp_UlsOSUlR35Qz","name":"JWeather","description":"Integrates with weather data services to provide real-time conditions and forecasts through an asyncio-powered Python server with automated CI/CD workflows.","logo":"https://avatar

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

query_weather

Claude Desktop / Cursor

Linux

Macos

Windows

Juhe Weather MCP Server

Components

Tools

Install

Using uv (recommended)

Using PIP

Configuration

Environment Variables

Configure For CLINE

Debugging

Examples of Questions for Cline

Install

More like this

Time

Sentry

Github

Git

GitLab

Context 7

`query_weather`