python3 --version

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# 使用 npm 安装
npm install -g @anthropic-ai/claude-code

# 或使用 brew（macOS）
brew install claude-code

claude login

# 使用 uv 初始化项目
uv init weather-mcp-server
cd weather-mcp-server

# 添加依赖
uv add "mcp[cli]" httpx python-dotenv

weather-mcp-server/
├── main.py              # 主程序
├── pyproject.toml       # 项目配置
├── .env                 # 环境变量（敏感信息）
├── .env.example         # 环境变量模板
├── .gitignore           # Git 忽略文件
└── README.md           # 项目说明

# 高德地图 API 配置
AMAP_KEY=your_api_key_here
AMAP_HOST=https://restapi.amap.com

# 高德地图 API 配置
AMAP_KEY=0fb72bcad*********739221bf  # 替换成你的 Key
AMAP_HOST=https://restapi.amap.com

.env

import json
import os
import httpx
from mcp.server import FastMCP
from mcp.types import TextContent
from dotenv import load_dotenv

# 加载 .env 文件中的环境变量
load_dotenv()

# 创建 FastMCP 应用实例
app = FastMCP("weather-mcp-server")

# 从环境变量读取配置
HOST = os.getenv("AMAP_HOST", "https://restapi.amap.com")
KEY = os.getenv("AMAP_KEY")


# 定义工具：查询天气
@app.tool(
    name="query_weather",
    description="查询指定地区的天气情况"
)
async def query_weather(address: str) -> list[TextContent]:
    """
    查询指定地区的天气

    Args:
        address: 地区名称，如 "北京"、"上海"

    Returns:
        天气信息列表
    """
    async with httpx.AsyncClient() as client:
        try:
            # 步骤1: 通过地址获取地理编码（adcode）
            resp = await client.get(
                f"{HOST}/v3/geocode/geo",
                params={"key": KEY, "address": address}
            )

            if resp.status_code != 200:
                return [TextContent(
                    type="text",
                    text=f"请求失败: {resp.status_code}"
                )]

            resp_dict = json.loads(resp.text)

            # 注意：高德 API 的 status 是字符串 "1"
            if resp_dict["status"] != "1":
                return [TextContent(
                    type="text",
                    text=f"地理编码失败: {resp_dict['info']}"
                )]

            # 获取城市代码
            city = resp_dict["geocodes"][0]["adcode"]

            # 步骤2: 通过城市代码查询天气
            resp = await client.get(
                f"{HOST}/v3/weather/weatherInfo",
                params={"key": KEY, "city": city}
            )

            if resp.status_code != 200:
                return [TextContent(
                    type="text",
                    text=f"天气查询失败: {resp.status_code}"
                )]

            resp_dict = json.loads(resp.text)

            if resp_dict["status"] != "1":
                return [TextContent(
                    type="text",
                    text=f"天气查询失败: {resp_dict['info']}"
                )]

            # 返回天气数据
            return [TextContent(type="text", text=resp.text)]

        except Exception as e:
            return [TextContent(
                type="text",
                text=f"发生错误: {str(e)}"
            )]


# 程序入口
if __name__ == "__main__":
    # 以 stdio 模式运行（Claude Code CLI 需要）
    # 这里也能换成 sse 那么对应的 mcp 的配置也需要进行调整
    app.run(transport="stdio")

mcp dev main.py

{
  "mcpServers": {
    "weather": {
      "command": "uv",
      "args": [
        "--directory",
        "/你的项目路径/weather-mcp-server",
        "run",
        "main.py"
      ]
    }
  }
}

uv --directory 你得mcp项目路径 run main.py

{
  "mcpServers": {
    "weather": {
      "url": "http://127.0.0.1:8080/sse"
    }
  }
}

# 启动 Claude Code
claude

# 验证 mcp 是否加载成功
/mcp

你: 北京今天天气怎么样？

Claude: 让我帮你查询北京的天气。

[调用 query_weather 工具]

根据查询结果，北京今天多云，气温 15-25℃，东南风 3-4级，
空气质量良好。建议穿着轻薄外套，适合外出活动。

你: 上海呢？

Claude: [调用 query_weather 工具]
上海今天小雨，气温 18-22℃，请记得带伞哦！

# 解析天气数据
weather_data = resp_dict["lives"][0]
formatted_text = f"""
城市：{weather_data['province']} {weather_data['city']}
天气：{weather_data['weather']}
温度：{weather_data['temperature']}℃
风向：{weather_data['winddirection']}风
风力：{weather_data['windpower']}级
湿度：{weather_data['humidity']}%
更新时间：{weather_data['reporttime']}
"""

return [TextContent(type="text", text=formatted_text)]

if not KEY:
    return [TextContent(
        type="text",
        text="错误：未配置 AMAP_KEY，请检查 .env 文件"
    )]

import logging

logging.basicConfig(level=logging.INFO)
logger = logging.getLogger(__name__)

logger.info(f"查询天气: {address}")

@app.tool(name="query_weather_batch")
async def query_weather_batch(cities: list[str]):
    """批量查询多个城市的天气"""
    results = []
    for city in cities:
        # ... 查询逻辑
        results.append(weather_info)
    return results

# 直接运行看错误信息
uv run python main.py