MCPサーバー

天気および時刻ツールを備えた拡張可能なModel Context Protocol (MCP)サーバーです。学習用に構築されており、Claude Desktopに接続してすぐにチャットを開始できます。

はじめに

1. クローンとインストール

git clone <repo-url> && cd mcp-server
python3 -m venv .venv
source .venv/bin/activate   # macOS / Linux / WSL
pip install -e .

または uv を使用する場合:

git clone <repo-url> && cd mcp-server
uv venv
source .venv/bin/activate
uv pip install -e .

2. Claude Desktopへの接続

セットアップスクリプトを実行して、Claude Desktopの設定ファイルを自動的に書き込みます:

macOS:

python setup_claude_agent.py

これにより、プロジェクトの .venv/bin/python を指す ~/Library/Application Support/Claude/claude_desktop_config.json が書き込まれます。

プロジェクトが標準以外の場所にある場合は、明示的にパスを渡してください:

python setup_claude_agent.py --project-path /path/to/mcp-server

Windows (WSL経由):

python3 setup_claude_agent.py --windows --win-user <YourWindowsUser> --wsl-user <YourWSLUser>

例:

python3 setup_claude_agent.py --windows --win-user Cam --wsl-user cam

これにより、%APPDATA%\Claude\claude_desktop_config.json が書き込まれ、WSL経由でサーバーを起動するようにClaude Desktopが設定されます。

3. Claude Desktopの再起動

Claude Desktopを閉じてから再度開きます。サーバーが接続されていることを確認するには、設定 → 開発者に移動してください。mcp-server と緑色の 実行中 バッジが表示されるはずです。

4. 試してみる

Claudeに以下のように尋ねてみてください:

• 「今何時？」 — get_current_time ツールを使用します

• 「カリフォルニア州の気象警報を取得して」 — weather://alerts/CA リソースを使用します

• 「緯度40.7128、経度-74.0060の天気予報は？」 — 予報リソースを使用します

サーバーを手動で起動する必要はありません。Claude Desktopが自動的に起動します。

Related MCP server: mcp-weather

利用可能なツールとリソース

独自のツールの追加

src/mcp_server/server.py を開き、@mcp.tool() デコレータを使用して関数を追加します:

@mcp.tool()
async def my_tool(param: str) -> str:
    """Description of what this tool does."""
    return f"Result for {param}"

Claude Desktopを再起動して変更を反映させます。

リソースとプロンプトについては、CONTRIBUTING.md を参照してください。

テストの実行

pip install -e ".[dev]"   # or: uv pip install -e ".[dev]"
pytest

プロジェクト構造

src/mcp_server/
├── server.py              # MCP server entry point — register tools here
└── tools/
    ├── weather/           # Weather alerts & forecasts (NWS API)
    ├── time/              # IP-based timezone & current time
    └── conversation/      # Conversation tools

ライセンス

MIT

リソース

• Model Context Protocol ドキュメント

• National Weather Service API

• MCPサーバーの構築