1
{
2
  "jsonrpc": "2.0",
3
  "method": "tools/call",
4
  "params": {
5
    "name": "get_weather",
6
    "arguments": { "city": "Haikou" }
7
  },
8
  "id": 1
9
}

1
{
2
  "jsonrpc": "2.0",
3
  "result": {
4
    "temperature": 30,
5
    "condition": "Sunny"
6
  },
7
  "id": 1
8
}

1
{
2
  "mcpServers": {
3
    "mcp-server-chart": {
4
      "command": "npx",
5
      "args": [
6
        "-y",
7
        "@antv/mcp-server-chart"
8
      ]
9
    }
10
  }
11
}

1
iwr -useb https://astral.sh/uv/install.ps1 | iex
2

3
# 检测是否下载成功
4
uv --version
5
uv 0.8.11 (f892276ac 2025-08-14)

1
# 安装依赖（根据 pyproject.toml 和 uv.lock）
2
uv sync
3

4
# 运行程序
5
uv run python main.py
6

7
#添加/删除依赖（会自动更新 pyproject.toml 与 uv.lock）
8
uv add requests
9
uv remove requests
10

11
# 固定/复现环境，严格按锁文件安装：
12
uv sync --frozen
13

14
# Python 版本（你的仓库已有 .python-version，uv 会按此安装/使用）
15
# 安装对应解释器：
16
uv python install
17
# 查看已装版本：
18
uv python list

1
┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
2
│   Cherry        │◄──►│   MCP Server    │◄──►│  外部API服务     │
3
│   (客户端)       │    │  (你的代码)      │    │ (天气API等)      │
4
└─────────────────┘    └─────────────────┘    └─────────────────┘

1
from typing import Any
2
import httpx
3
from mcp.server.fastmcp import FastMCP
4

5
# Initialize FastMCP server
6
mcp = FastMCP("weather")
7

8
# Constants
9
NWS_API_BASE = "https://api.weather.gov"
10
USER_AGENT = "weather-app/1.0"
11

12
async def make_nws_request(url: str) -> dict[str, Any] | None:
13
    """Make a request to the NWS API with proper error handling."""
14
    headers = {
15
        "User-Agent": USER_AGENT,
16
        "Accept": "application/geo+json"
17
    }
18
    async with httpx.AsyncClient() as client:
19
        try:
20
            response = await client.get(url, headers=headers, timeout=30.0)
21
            response.raise_for_status()
22
            return response.json()
23
        except Exception:
24
            return None
25

26
def format_alert(feature: dict) -> str:
27
    """Format an alert feature into a readable string."""
28
    props = feature["properties"]
29
    return f"""
30
Event: {props.get('event', 'Unknown')}
31
Area: {props.get('areaDesc', 'Unknown')}
32
Severity: {props.get('severity', 'Unknown')}
33
Description: {props.get('description', 'No description available')}
34
Instructions: {props.get('instruction', 'No specific instructions provided')}
35
"""
36

37
@mcp.tool()
38
async def get_alerts(state: str) -> str:
39
    """Get weather alerts for a US state.
40

41
    Args:
42
        state: Two-letter US state code (e.g. CA, NY)
43
    """
44
    url = f"{NWS_API_BASE}/alerts/active/area/{state}"
45
    data = await make_nws_request(url)
46

47
    if not data or "features" not in data:
48
        return "Unable to fetch alerts or no alerts found."
49

50
    if not data["features"]:
51
        return "No active alerts for this state."
52

53
    alerts = [format_alert(feature) for feature in data["features"]]
54
    return "\n---\n".join(alerts)
55

56
@mcp.tool()
57
async def get_forecast(latitude: float, longitude: float) -> str:
58
    """Get weather forecast for a location.
59

60
    Args:
61
        latitude: Latitude of the location
62
        longitude: Longitude of the location
63
    """
64
    # First get the forecast grid endpoint
65
    points_url = f"{NWS_API_BASE}/points/{latitude},{longitude}"
66
    points_data = await make_nws_request(points_url)
67

68
    if not points_data:
69
        return "Unable to fetch forecast data for this location."
70

71
    # Get the forecast URL from the points response
72
    forecast_url = points_data["properties"]["forecast"]
73
    forecast_data = await make_nws_request(forecast_url)
74

75
    if not forecast_data:
76
        return "Unable to fetch detailed forecast."
77

78
    # Format the periods into a readable forecast
79
    periods = forecast_data["properties"]["periods"]
80
    forecasts = []
81
    for period in periods[:5]:  # Only show next 5 periods
82
        forecast = f"""
83
{period['name']}:
84
Temperature: {period['temperature']}°{period['temperatureUnit']}
85
Wind: {period['windSpeed']} {period['windDirection']}
86
Forecast: {period['detailedForecast']}
87
"""
88
        forecasts.append(forecast)
89

90
    return "\n---\n".join(forecasts)
91

92
if __name__ == "__main__":
93
    # Initialize and run the server
94
    mcp.run(transport='stdio')

1
{
2
  "mcpServers": {
3
    "weather": {
4
      "command": "uv",
5
      "args": [
6
        "--directory",
7
        "g:\\shared\\mcp-learn\\my-mcp-server",
8
        "run",
9
        "weather.py"
10
      ]
11
    }
12
  }
13
}

1
{
2
  "params": {
3
    "state": "CA"
4
  },
5
  "response": {
6
    "content": [
7
      {
8
        "type": "text",
9
        "text": "\nEvent: Wind Advisory\nArea: Santa Barbara County Southwestern Coast; Santa Ynez Mountains Western Range\nSeverity: Moderate\nDescription: * WHAT...North to northwest winds 20 to 30 mph with gusts up to 45\nmph.\n\n* WHERE...Santa Barbara County Southwestern Coast and Santa Ynez\nMountains Western Range.\n\n* WHEN...Until 5 AM PDT Friday.\n\n* IMPACTS...Gusty winds will blow around unsecured objects. Tree\nlimbs could be blown down and a few power outages may result.\nInstructions: Winds this strong can make driving difficult, especially for high\nprofile vehicles. Use extra caution.\n"
10
      }
11
    ],
12
    "structuredContent": {
13
      "result": "\nEvent: Wind Advisory\nArea: Santa Barbara County Southwestern Coast; Santa Ynez Mountains Western Range\nSeverity: Moderate\nDescription: * WHAT...North to northwest winds 20 to 30 mph with gusts up to 45\nmph.\n\n* WHERE...Santa Barbara County Southwestern Coast and Santa Ynez\nMountains Western Range.\n\n* WHEN...Until 5 AM PDT Friday.\n\n* IMPACTS...Gusty winds will blow around unsecured objects. Tree\nlimbs could be blown down and a few power outages may result.\nInstructions: Winds this strong can make driving difficult, especially for high\nprofile vehicles. Use extra caution.\n"
14
    },
15
    "isError": false
16
  }
17
}