mcpapp1 — 天気 MCP サーバー

Claude Desktop、Claude Code、Cursor などの MCP クライアントに米国のリアルタイムの気象警報を公開する、小さな Model Context Protocol サーバーです。

データは National Weather Service API から取得します。この API は無料で、API キーは不要です。

公開するもの

Related MCP server: Weather Alert & Forecast MCP Tool

要件

• Python 3.13+

• uv

セットアップ

git clone https://github.com/eyosiasbisrat/mcpapp1.git
cd mcpapp1
uv sync

実行

stdio 経由でサーバーを直接実行します:

uv run server/weather.py

または MCP CLI 経由:

uv run mcp run server/weather.py

MCP Inspector で対話的に検査する:

uv run mcp dev server/weather.py

MCP サーバーは stdin/stdout 上で JSON-RPC を使用して通信するため、手動で実行すると入力待ちで静かに待機するだけです。これは想定どおりです。通常はクライアントがサーバーを起動します。

クライアントを接続する

Claude Code / Cursor

両方の設定ファイルはすでにチェックインされており、相対パスを使用しているため、uv sync の後に編集なしで動作します:

• .mcp.json — Claude Code

• .cursor/mcp.json — Cursor

エディタのウィンドウをリロードし、プロンプトが表示されたらサーバーを承認してください。

Claude Desktop

uv run mcp install server/weather.py

その後、Claude Desktop を完全に終了します。ウィンドウを閉じても実行中のままになるため、トレイアイコンも含めて終了してください。そして再度開きます。

Claude Desktop が確実にインストールされているのに Claude app not found と表示される場合は、以下を参照してください。

トラブルシューティング

Windows での Claude app not found

mcp install は Claude Desktop の設定を固定の場所で探します:

%APPDATA%\Claude

Claude Desktop が MSIX / Microsoft Store パッケージとしてインストールされている場合、そのデータはパッケージコンテナにリダイレクトされ、そのディレクトリは存在しません:

%LOCALAPPDATA%\Packages\Claude_<id>\LocalCache\Roaming\Claude\claude_desktop_config.json

これを解決する方法は 2 つあります。

実際の設定を直接編集する — 上記のパッケージ化されたパスにある claude_desktop_config.json に mcpServers エントリを追加します。既存のキーはすべて保持します。

または、ディレクトリジャンクションでパスを一度ブリッジする — これ以降、mcp install はすべてのサーバーで正常に動作します:

cmd /c mklink /J "%APPDATA%\Claude" "%LOCALAPPDATA%\Packages\Claude_<id>\LocalCache\Roaming\Claude"

実際のパッケージフォルダ名を Claude_<id> に置き換えてください。元に戻すには、cmd /c rmdir "%APPDATA%\Claude" を実行すると、設定ではなくリンクのみが削除されます。

Windows でサーバーを手動で登録する場合は、uv の絶対パスを使用してください（例: C:\Users\<you>\.local\bin\uv.exe）。パッケージ化されたアプリはシェルの PATH を確実に継承しないため、素の uv では起動に失敗する可能性があります。

サーバーが実際に読み込まれていることを確認する

プロセスの親子関係を確認して、クライアントがサーバーを起動したことを確認します:

Get-CimInstance Win32_Process -Filter "Name='uv.exe'" | ForEach-Object {
  $p = Get-CimInstance Win32_Process -Filter "ProcessId=$($_.ParentProcessId)"
  "$($_.ProcessId) <- $($p.Name)"
}

親が Claude.exe である uv.exe があれば、サーバーは実行中です。一部の Claude Desktop ビルドはサーバーごとのログを logs\ に書き込まないため、ログフォルダが空でも失敗の証拠にはならないことに注意してください。

プロジェクト構成

server/weather.py     the MCP server: tool, resource, and NWS client
main.py               placeholder entrypoint
.mcp.json             Claude Code server config
.cursor/mcp.json      Cursor server config
pyproject.toml        dependencies (httpx, mcp[cli])

注意事項

• get_alerts は米国の州のみを対象としています。NWS は米国の機関であるためです。

• リクエストには User-Agent ヘッダーが含まれます。これは NWS API が要求するものです。

• ネットワークエラーと HTTP エラーは握りつぶされ、トレースバックではなく、親しみやすい "unable to fetch" メッセージとして表示されます。