MCP クラッシュコース

MCP（Model Control Protocol）および関連テクノロジーを学習・実験するためのPythonベースのプロジェクトです。

プロジェクト概要

このプロジェクトは、MCPおよび関連テクノロジーを扱うためのクラッシュコースとして機能します。FastAPI統合、埋め込み機能、Groqを使用したLangChain統合が含まれています。

Related MCP server: MCP Server Sample

このプロジェクトの特徴

主な利点

1. シンプルなモデル管理

   • モデルのデプロイと制御のための合理化されたインターフェース

   • さまざまなタイプのモデルを扱うための統一されたアプローチ

   • モデル操作の複雑さの軽減

2. パフォーマンスの向上

   • スループット向上のための非同期処理

   • 最適化された埋め込み操作

   • 効率的なリソース利用

3. 開発者フレンドリー

   • 明確なAPIドキュメント

   • 直感的なCLIツール

   • 包括的なエラーハンドリング

4. スケーラビリティ

   • 容易な拡張のためのモジュール式アーキテクチャ

   • 複数のモデルタイプのサポート

   • 柔軟なデプロイオプション

インストール

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

git clone <repository-url>
cd mcpcrashcourse

2. 仮想環境を作成して有効化します:

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

3. 依存関係をインストールします:

pip install -e .

プロジェクトのワークフロー

サーバーアーキテクチャ

このプロジェクトは、2つの主要なサーバーコンポーネントで構成されています:

• server/: メインのアプリケーションサーバー実装が含まれています

• mcpserver/: MCP固有のサーバー機能が含まれています

主要コンポーネント

1. FastAPI統合

   • モデル操作のためのRESTful APIエンドポイント

   • 高性能操作のための非同期サポート

   • 組み込みのドキュメントおよびテスト機能

   • 自動リクエスト検証

   • Swagger/OpenAPIドキュメント

2. 埋め込みシステム

   • 効率的なテキスト埋め込みにFastEmbedを利用

   • さまざまな埋め込みモデルのサポート

   • セマンティック検索と類似性マッチングの実現

   • バッチ処理機能

   • メモリ効率の高い操作

3. LangChain統合

   • LLM操作のためのGroqとの統合

   • モデルの入出力のチェーンベース処理

   • カスタマイズ可能なパイプライン構成

   • 複雑なワークフローのサポート

   • 外部サービスとの容易な統合

4. MCP実装

   • Model Control Protocolの実装

   • モデル管理のためのCLIツール

   • 構成およびデプロイ用ユーティリティ

   • ヘルスモニタリングとロギング

   • 自動フェイルオーバーサポート

内部の仕組み

1. リクエスト処理フロー

   Client Request → FastAPI Router → Model Handler → MCP Controller → Model Execution → Response Formatter → Client

2. モデル管理

   • モデルの自動ロードとアンロード

   • リソース割り当ての最適化

   • 同時リクエスト処理

   • 状態管理と永続化

3. エラーハンドリング

   • グレースフルデグラデーション

   • 詳細なエラー報告

   • 自動復旧メカニズム

   • ロギングとモニタリング

開発ワークフロー

1. ローカル開発

   • 開発サーバーを起動します:

     python main.py

   • サーバーはデフォルトでlocalhost:8000で実行されます

   • APIドキュメントは/docsで利用できます

   • 開発用のホットリロード

   • デバッグモードのサポート

2. モデル統合

   • 適切なサーバーディレクトリでモデルを構成します

   • APIキーの環境変数を設定します

   • APIエンドポイントを通じてモデルの操作をテストします

   • モデルのバージョニングサポート

   • A/Bテスト機能

3. テストとデプロイ

   • 自動テストを実行します

   • 本番環境にデプロイします

   • モデルのパフォーマンスとAPIメトリクスを監視します

   • 継続的インテグレーションのサポート

   • 自動デプロイパイプライン

一般的な操作

1. サーバーの起動

   python main.py

2. APIエンドポイントへのアクセス

   • FastAPIのドキュメントインターフェースを使用します

   • 適切なエンドポイントにHTTPリクエストを送信します

   • レスポンスとエラーを適切に処理します

   • レート制限とスロットリング

   • 認証と認可

3. モデル管理

   • モデル操作にMCP CLIツールを使用します

   • モデルパラメータを構成します

   • モデルのパフォーマンスを監視します

   • モデルのバージョン管理

   • リソース割り当ての管理

プロジェクト構成

• main.py: アプリケーションのメインエントリポイント

• server/: サーバー関連コンポーネント

• mcpserver/: MCPサーバー実装

• pyproject.toml: プロジェクト構成と依存関係

• finalmcp.pdf: ドキュメントまたはコース資料

依存関係

このプロジェクトは、いくつかの主要な依存関係を使用しています:

• FastAPI (>=0.115.12)

• FastEmbed (>=0.6.1)

• LangChain-Groq (>=0.3.2)

• MCP-Use (>=1.2.8)

• MCP[CLI] (>=1.6.0)