JinDaGe - mcp_weather MCP Details

article

README

🚀 天气 MCP 服务器

天气 MCP 服务器是一个基于 Model Context Protocol 的服务器，它提供了天气预报和城市信息查询功能。该服务器允许大语言模型（LLMs）获取未来 24 小时的天气信息，并且支持通过城市名称、经纬度等方式查询城市信息。

🚀 快速开始

🔍 可用工具

get_24h_weather - 获取未来 24 小时的天气预报。
- 必需参数：
  - location (string): 城市名称或经纬度（例如，北京或 116.41,39.92）

📦 安装指南

🛠️ 使用 uv（推荐）

使用uv时无需特定安装。我们将使用uvx直接运行mcp-server-weather。

📦 使用 PIP

或者，你可以通过 pip 安装mcp-server-weather：

pip install mcp-server-weather

安装后，你可以使用以下命令作为脚本运行：

python -m mcp_server_weather

🛠️ 配置

⚙️ 配置 Claude.app

在 Claude 设置中添加：

使用 uvx

"mcpServers": {
  "weather": {
    "command": "uvx",
    "args": ["mcp-server-weather"]
  }
}

使用 docker

"mcpServers": {
  "weather": {
    "command": "docker",
    "args": ["run", "-i", "--rm", "mcp/weather"]
  }
}

使用 pip 安装

"mcpServers": {
  "weather": {
    "command": "python",
    "args": ["-m", "mcp_server_weather"]
  }
}

⚙️ 配置 Zed

在 Zed 的 settings.json 中添加：

使用 uvx

"context_servers": [
  "mcp-server-weather": {
    "command": "uvx",
    "args": ["mcp-server-weather"]
  }
],

使用 pip 安装

"context_servers": {
  "mcp-server-weather": {
    "command": "python",
    "args": ["-m", "mcp_server_weather"]
  }
},

💻 使用示例

📅 获取未来 24 小时天气

{
  "name": "get_24h_weather",
  "arguments": {
    "location": "广州 天河"
  }
}

响应：

{
  "location": "广州 天河",
  "forecast": "未来24小时的天气信息..."
}

🔧 调试

你可以使用 MCP inspector 来调试服务器。对于 uvx 安装：

npx @modelcontextprotocol/inspector uvx mcp-server-weather

或者如果你在特定目录中安装了包或正在开发：

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

🛠️ 构建

🐳 Docker 构建

docker build -t mcp/weather .

🤝 贡献

我们鼓励对 mcp-server-weather 的贡献，以帮助扩展和改进其功能。无论是添加新的天气相关工具、增强现有功能，还是改进文档，你的输入都很有价值。

有关其他 MCP 服务器的更多信息，请参阅此处。

📄 许可证

该软件遵循MIT License协议。

mcp_weather