MCP Client

MCP クライアント

MCP サーバーと連携するための Python クライアントです。例として天気ツールサーバーを搭載しています。クライアントは自然言語での問い合わせに Anthropic の Claude API を使用し、互換性のある任意の MCP サーバースクリプトに接続できます。

特長

• MCP サーバー向けの対話型チャットクライアント
• 天気サーバーの例（server/weather.py）。次の機能を備えています：
  • 米国各州の気象警報
  • 場所に基づく天気予報（NWS API 経由）
• 拡張可能：MCP 互換の任意のサーバースクリプトに接続できます
• 自然言語の理解に Anthropic Claude API を使用

要件

• Python 3.12+
• Anthropic API キー
• MCP Python パッケージ（mcp>=1.9.2）
• uv（分離された環境での実行用。任意ですが推奨）

インストール

1. リポジトリをクローンします：

   git clone <your-repo-url>
   cd mcp-client
   

2. 依存関係をインストールします：

   uv pip install -r requirements.txt
   

   uv と pyproject.toml を使用する場合：

   uv pip install
   

3. Anthropic API キーを設定します：

   • プロジェクトのルートに .env ファイルを作成します：

     ANTHROPIC_API_KEY=your-anthropic-api-key-here
     

   • .env ファイルは .gitignore に含まれており、自動的に読み込まれます。

使い方

天気サーバーを起動する

天気サーバーの例は server/weather.py にあります。get_alerts と get_forecast の 2 つのツールを提供します。

クライアントを実行する

次のコマンドでクライアントを天気サーバーに接続できます：

uv run client.py ./server/weather.py

または、通常の Python を使用する場合：

python client.py ./server/weather.py

次のような出力が表示されます：

Connected to server with tools: ['get_alerts', 'get_forecast']

MCP Client Started!
Type your queries or 'quit' to exit.

問い合わせ例

• What is the weather in New York?
• Are there any weather alerts for CA?
• Give me the forecast for latitude 40.7, longitude -74.0

終了

チャットループを終了するには、quit と入力します。

プロジェクト構成

.
├── client.py            # Main MCP client
├── server/
│   └── weather.py       # Example weather MCP server
├── pyproject.toml       # Project metadata and dependencies
├── .env                 # (Not committed) Your API keys
├── .gitignore
└── README.md

開発

• クライアントは python-dotenv を使って .env から環境変数を読み込みます。
• 天気サーバーは米国国立気象局の API を使用し、インターネット接続が必要です。

トラブルシューティング

• Anthropic API エラー：
  API キーが有効で、十分なクレジットがあることを確認してください。
• Python のバージョン：
  このプロジェクトには Python 3.12 以降が必要です。
• ネットワークの問題：
  天気サーバーは https://api.weather.gov に接続する必要があります。

ライセンス