MCP Client Example ☀️

MCP クライアント例 ☀️

このプロジェクトは、Model Context Protocol (MCP) を使用したシンプルなクライアント・サーバー実装を示しています。MCP は、大規模言語モデルをツールやデータに接続するための標準化された方法です。

概要

このサンプルでは以下の方法を示しています：

• カスタムツールを備えた MCP サーバーを作成する
• MCP クライアントを使用してサーバーに接続する
• ツールを呼び出してサーバーからレスポンスを取得する

チュートリアルビデオ

上の画像をクリックして、MCP 実装に関するチュートリアルを視聴してください。

プロジェクト構造

.
├── pyproject.toml
├── README.md
├── src
│   ├── client
│   │   └── mcp_client.py      # MCP client implementation
│   └── server
│       └── example_server.py  # MCP server with tools
└── uv.lock

サーバー実装

サーバーは 2 つのツールを公開しています：

1. calculate_bmi - 体格指数 (BMI) を計算するシンプルな計算機
2. fetch_weather - 外部 API から天気データを取得する非同期ツール

クライアント実装

クライアントは stdio 経由でサーバーに接続し、セッションを初期化してサーバーのツールを呼び出します。

はじめに

前提条件

• Python 3.9+
• uv (Python パッケージマネージャー)

インストール

# Install dependencies
uv install -e .

サンプルの実行

1. クライアントを起動します (自動的にサーバーも起動されます)：

uv run src/client/mcp_client.py

使用方法

クライアントは以下を実行します：

1. サーバーに接続する
2. 利用可能なツールをリストアップする
3. サンプルデータを使用して BMI 計算機を呼び出す
4. サンプル座標を使用して天気ツールを呼び出す

レスポンス例

Available tools: meta=None nextCursor=None tools=[...]
BMI calculation result: 22.857142857142858
Weather data: {"current_weather":{"temperature":14.2,"windspeed":12.6, ...}}

MCP Inspector でテストする

( 下のコマンドを実行してから http://localhost:5173 にアクセスしてください )

  ❯ mcp dev src/server/example_server.py
Starting MCP inspector...
Proxy server listening on port 3000

🔍 MCP Inspector is up and running at http://localhost:5173 🚀
New SSE connection
Query parameters: {
  transportType: 'stdio',
  command: 'uv',
  args: 'run --with mcp mcp run src/server/example_server.py',

リソース

このプロジェクトは以下を使用しています：

• Model Context Protocol Python SDK
• MCP 公式ドキュメント

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細は LICENSE ファイルを参照してください。