パッケージのインストール

# uvを使う場合（推奨）\nuv add "mcp[cli]"\n\n# pipを使う場合\npip install "mcp[cli]"

weather_server.py

from mcp.server.fastmcp import FastMCP\n\nmcp = FastMCP("Weather Tool")\n\n@mcp.tool()\ndef get_weather(city: str) -> str:\n    """指定した都市の現在の天気を返す。\n\n    Args:\n        city: 天気を調べたい都市名（例: "東京", "大阪"）\n    """\n    # ダミー実装。実際は外部の天気APIを呼び出す\n    return f"{city}の天気は晴れ、気温は22度です"\n\nif __name__ == "__main__":\n    mcp.run()

動作確認

python weather_server.py

サーバーの登録

claude mcp add weather-tool --transport stdio -- python weather_server.py

環境変数つきの登録例

claude mcp add weather-tool --transport stdio \\\n  --env WEATHER_API_KEY=your_key_here \\\n  -- python weather_server.py

動作確認

/mcp\n# weather-tool が接続済みとして表示されればOK

config.toml

[mcp_servers.weather-tool]\ncommand = "python"\nargs = ["weather_server.py"]

外部API呼び出しの例

import httpx\n\n@mcp.tool()\ndef check_inventory(product_code: str) -> str:\n    """指定した商品コードの在庫数を社内在庫システムから取得する。\n\n    Args:\n        product_code: 商品コード（例: "SKU-1234"）\n    """\n    response = httpx.get(\n        f"https://internal-api.example.com/inventory/{product_code}",\n        headers={"Authorization": f"Bearer {os.environ['INVENTORY_API_KEY']}"},\n    )\n    response.raise_for_status()\n    data = response.json()\n    return f"{product_code}の在庫数は{data['stock']}個です"

エラーハンドリングの例

@mcp.tool()\ndef check_inventory(product_code: str) -> str:\n    """指定した商品コードの在庫数を取得する。"""\n    try:\n        response = httpx.get(f"...{product_code}", timeout=5.0)\n        response.raise_for_status()\n    except httpx.TimeoutException:\n        return "エラー: 在庫システムへの接続がタイムアウトしました。時間をおいて再試行してください。"\n    except httpx.HTTPStatusError as e:\n        if e.response.status_code == 404:\n            return f"エラー: 商品コード「{product_code}」が見つかりません。コードを確認してください。"\n        return f"エラー: 在庫システムでエラーが発生しました（ステータス{e.response.status_code}）"\n    return f"{product_code}の在庫数は{response.json()['stock']}個です"