MCP Client X

🚀 MCP クライアントサンプル ☀️

このプロジェクトは、大規模言語モデルをツールやデータに接続するための標準的な方法であるモデルコンテキストプロトコル（MCP）を使用した、シンプルなクライアント - サーバーの実装をデモンストレーションしています。

🚀 クイックスタート

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

• カスタムツールを持つMCPサーバーを作成する方法
• MCPクライアントを使用してサーバーに接続する方法
• ツールを呼び出し、サーバーから応答を取得する方法

チュートリアル動画

上の画像をクリックすると、MCPの実装に関するチュートリアルを視聴できます。

✨ 主な機能

サーバーの機能

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

1. calculate_bmi - 身体質量指数（BMI）を計算するためのシンプルな計算機
2. fetch_weather - 外部APIから天気データを取得する非同期ツール

クライアントの機能

クライアントは標準入出力を介してサーバーに接続し、セッションを初期化し、サーバーのツールを呼び出します。

📦 インストール

前提条件

• Python 3.9+
• uv（Pythonパッケージマネージャー）

インストール手順

# 依存関係をインストールする
uv install -e .

サンプルの実行

1. クライアントを起動する（サーバーも自動的に起動されます）：

uv run src/client/mcp_client.py

💻 使用例

基本的な使用法

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

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

サンプル応答

利用可能なツール：meta=None nextCursor=None tools=[...]
BMI計算結果：22.857142857142858
天気データ：{"current_weather":{"temperature":14.2,"windspeed":12.6, ...}}

MCPインスペクターを使用したテスト

（以下のコマンドを実行した後、http://localhost:5173 にアクセスします）

  ❯ mcp dev src/server/example_server.py
MCPインスペクションツールを起動します...
プロキシサーバーがポート3000で待機しています

🔍 MCPインスペクションツールが起動し、http://localhost:5173 で実行中です 🚀
新しいSSE接続
クエリパラメータ：{
  transportType: 'stdio',
  command: 'uv',
  args: 'run --with mcp mcp run src/server/example_server.py',

📚 ドキュメント

プロジェクト構造

.
├── pyproject.toml
├── README.md
├── src
│   ├── client
│   │   └── mcp_client.py      # MCPクライアントの実装
│   └── server
│       └── example_server.py  # ツール付きのMCPサーバー
└── uv.lock

リソース

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

• モデルコンテキストプロトコルPython SDK
• MCP公式ドキュメント

📄 ライセンス

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