Model Context Protocol (MCP) Server

Model Context Protocol（MCP）サーバー

教育目的で作成された、Model Context Protocol サーバーの基本的な実装です。このサーバーでは、MCP の基本概念と、Python を使って実際に実装する方法を説明します。

特徴

• FastAPI と WebSockets を使用した WebSocket ベースの通信
• Pydantic モデルを使用した基本的な MCP メッセージ処理
• モデルコンテキスト管理のサポート
• シンプルなクライアントとサーバーのやり取り
• パフォーマンス向上のための async/await サポート

はじめに

1. 仮想環境を作成します（推奨）：

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

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

pip install -r requirements.txt

3. 開発サーバーを起動します：

python -m src.server

4. サンプルクライアントを実行します：

python examples/basic_usage.py

プロジェクト構成

src/
├── server.py          # Main server implementation
├── types/            # TypeScript type definitions
│   └── mcp.py        # MCP protocol types using Pydantic
└── examples/         # Example implementations
    └── basic_usage.py # Basic client example

MCP プロトコルの概要

Model Context Protocol（MCP）は、AI モデルとのやり取りのために設計された通信プロトコルです。この実装には、以下が含まれます。

• Pydantic モデルを使用したメッセージ形式の処理
• コンテキスト管理
• 基本的なプロトコル操作
• パフォーマンス向上のための async/await サポート

TypeScript 版との主な違い

1. Express の代わりに FastAPI を使用
2. パフォーマンス向上のために async/await を実装
3. データ検証とシリアライズに Pydantic を使用
4. より Python らしいコード構成とパターン MIT