MCP Server Client Tutorial Using Python

🚀 モデルコンテキストプロトコル（MCP）を使用したサーバーとクライアントの構築ガイド

このガイドでは、モデルコンテキストプロトコル（MCP）を使用してサーバーとクライアントを構築する手順を説明します。

🚀 クイックスタート

まずは、サーバーとクライアントの基本的な構造とコード例を見てみましょう。

✨ 主な機能

• サーバーとクライアントの構築が可能
• グラフィカルユーザーインターフェイス（GUI）のクライアントも作成できる
• システムの拡張やテストが容易

📦 インストール

サーバー側のインストール

pip install mcp-server

クライアント側のインストール

pip install mcp-client

GUI クライアントのインストール

pip install tkinter mcp-client

💻 使用例

サーバー側の基本的な使用法

from mcp_server import Server, Tool

class CalculatorTool(Tool):
    def add(self, a: int, b: int) -> int:
        return a + b

if __name__ == "__main__":
    server = Server()
    server.add_tool(CalculatorTool())
    server.start()

クライアント側の基本的な使用法

from mcp_client import ServerConnector

async def main():
    connector = ServerConnector("localhost", 1234)
    tools = await connector.connect()
    calculator_tool = tools["Calculator"]
    result = await calculator_tool.add(5, 3)  # 8を返す
    print(f"結果: {result}")

if __name__ == "__main__":
    import asyncio
    asyncio.run(main())

GUI クライアントの基本的な使用法

import tkinter as tk
from mcp_client import ServerConnector

class CalculatorApp:
    def __init__(self):
        self.window = tk.Tk()
        self.window.title("MCP 計算機クライアント")
        
        self.entry1 = tk.Entry(self.window)
        self.entry2 = tk.Entry(self.window)
        self.button = tk.Button(self.window, text="計算", command=self.calculate)
        self.result_label = tk.Label(self.window, text="")
        
        self.entry1.pack()
        self.entry2.pack()
        self.button.pack()
        self.result_label.pack()
    
    def calculate(self):
        try:
            a = int(self.entry1.get())
            b = int(self.entry2.get())
            connector = ServerConnector("localhost", 1234)
            tools = connector.connect_synchronously()
            calculator_tool = tools["Calculator"]
            result = calculator_tool.add(a, b)
            self.result_label.config(text=f"結果: {result}")
        except Exception as e:
            self.result_label.config(text=f"エラー: {str(e)}")

if __name__ == "__main__":
    app = CalculatorApp()
    app.window.mainloop()

📚 ドキュメント

サーバーの作成手順

ステップ 1: プロジェクト構造の初期化

mkdir server
cd server

ステップ 2: サーバーコードの初期化

nano server.py

以下の内容をファイルに追加します。

from mcp_server import Server, Tool

class CalculatorTool(Tool):
    def add(self, a: int, b: int) -> int:
        return a + b

if __name__ == "__main__":
    server = Server()
    server.add_tool(CalculatorTool())
    server.start()

ファイルを保存して閉じます。

ステップ 3: サーバーの起動

cd ..
python -m server.server_project_name.server

クライアントの作成手順

ステップ 1: プロジェクト構造の初期化

mkdir client
cd client

ステップ 2: クライアントコードの初期化

nano server_connector.py

以下の内容をファイルに追加します。

from mcp_client import ServerConnector

async def main():
    connector = ServerConnector("localhost", 1234)
    tools = await connector.connect()
    calculator_tool = tools["Calculator"]
    result = await calculator_tool.add(5, 3)  # 8を返す
    print(f"結果: {result}")

if __name__ == "__main__":
    import asyncio
    asyncio.run(main())

ファイルを保存して閉じます。

ステップ 3: クライアントの実行

cd ..
python -m client.server_connector

GUI クライアントの作成手順

ステップ 1: プロジェクト構造の初期化

mkdir client_ui
cd client_ui

ステップ 2: GUI コードの初期化

nano app.py

以下の内容をファイルに追加します。

import tkinter as tk
from mcp_client import ServerConnector

class CalculatorApp:
    def __init__(self):
        self.window = tk.Tk()
        self.window.title("MCP 計算機クライアント")
        
        self.entry1 = tk.Entry(self.window)
        self.entry2 = tk.Entry(self.window)
        self.button = tk.Button(self.window, text="計算", command=self.calculate)
        self.result_label = tk.Label(self.window, text="")
        
        self.entry1.pack()
        self.entry2.pack()
        self.button.pack()
        self.result_label.pack()
    
    def calculate(self):
        try:
            a = int(self.entry1.get())
            b = int(self.entry2.get())
            connector = ServerConnector("localhost", 1234)
            tools = connector.connect_synchronously()
            calculator_tool = tools["Calculator"]
            result = calculator_tool.add(a, b)
            self.result_label.config(text=f"結果: {result}")
        except Exception as e:
            self.result_label.config(text=f"エラー: {str(e)}")

if __name__ == "__main__":
    app = CalculatorApp()
    app.window.mainloop()

ファイルを保存して閉じます。

ステップ 3: GUI アプリケーションの実行

cd ..
python -m client_ui.app

🔧 技術詳細

システムの拡張

• 新しいツールの追加: サーバーで新しいツールクラスを定義し、server.py で登録します。
• GUI の強化: クライアントの GUI に減算、乗算、除算などの機能を追加します。
• 設定管理: サーバーのアドレスやその他の設定を管理するための設定ファイルを作成します。
• ログ記録: クライアントとサーバー間のやり取りを追跡するためのログ記録を実装します。

システムのテスト

サーバー側のテスト

cd server
python server.py

クライアントコマンドラインのテスト

cd ..
cd client
python server_connector.py

クライアント GUI のテスト

cd ..
cd client_ui
python app.py

まとめ

モデルコンテキストプロトコル（MCP）は、分散コンピューティングシステムを構築する強力な方法を提供します。このガイドに従えば、機能豊富なサーバーとクライアントを作成し、様々なニーズに合わせて拡張することができます。MCP の可能性を探求し、あなたのプロジェクトに応用してみましょう！