MCP Demo: Model Context Protocol Integration With Openai

🚀 MCP-Demo: Model Context Protocol 統合 OpenAI のデモ

このデモは、Model Context Protocol (MCP) を .NET アプリケーションで総合的に活用する方法を示しています。MCP クライアントとサーバーの作成、および OpenAI の大規模言語モデル（LLM）機能との統合方法を実演しています。

🚀 クイックスタート

このデモを通じて、MCP の基本的な機能や OpenAI との統合方法を学ぶことができます。以下の手順に沿って、デモを実行してみましょう。

✨ 主な機能

MCP サーバー

• いくつかの関数ベースのツールを提供します。
  • Echo：入力されたメッセージに挨拶を付けて返します。
  • Add：2 つの数値を足し合わせます。
  • GetDateTime：現在の日付と時刻を返します。

OpenAI 統合

• OpenAI API キーを使用して OpenAI API に接続します。
• 会話のコンテキストを維持します。
• AI の応答からツール呼び出しを抽出します。
• MCP サーバーを通じてツールを実行します。
• ツールの結果をユーザーに返します。

📦 インストール

前提条件

• .NET 9.0 SDK
• OpenAI API キー
• Visual Studio、VS Code または JetBrains Rider などのコードエディター

手順

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

   git clone https://your-repository-url/MCP-Demo.git
   cd MCP-Demo
   

2. ソリューションをビルドします。

   dotnet build
   

3. OpenAI API キーを設定します。

   cd MCP.LlmIntegration
   dotnet user-secrets set "OpenAI:ApiKey" "your-api-key-here"
   

デモの実行

1. LLM 統合アプリケーションを実行します。

   cd MCP.LlmIntegration
   dotnet run
   

2. アプリケーションは以下のことを自動的に行います。

   • MCP サーバーを起動します。
   • OpenAI API に接続します。
   • 対話型のチャットインターフェイスを提供します。
   • OpenAI を通じて MCP ツールを使用した対話を可能にします。

💻 使用例

基本的な使用法

基本計算

あなた：42 足す 17 はいくつ？

AI：Add ツールを使用して計算します。
[TOOL_CALL:Add(a=42, b=17)]

結果：42 + 17 = 59

現在の日付と時刻の取得

あなた：今の時刻は？

AI：GetDateTime ツールを使用して現在の日付と時刻を取得します。
[TOOL_CALL:GetDateTime]

応答：
日付：2023年10月5日
時刻：14:30:00

📚 ドキュメント

ソリューション構造

MCP-Demo/
├── MCP.Server/        # カスタムツール付きの MCP サーバー
├── MCP.Client/        # 簡単なテストクライアント
├── MCP.LlmIntegration/ # OpenAI 統合と MCP ツール
└── README.md          # このドキュメント

アーキテクチャ

• MCP サーバー：MCP API エンドポイントをホストし、管理します。ツールのリクエストを処理し、結果を返します。
• OpenAI 統合：OpenAI の .NET クライアントライブラリを使用して API とやり取りし、ツールの呼び出しを調整します。

プロジェクトの拡張

このプロジェクトを拡張するには、以下のことができます。

1. さらに多くのカスタムツールを実装し、MCP サーバーに統合します。
2. 既存のツールを拡張するか、新しい複雑なツールを作成して、より広範なニーズに対応します。
3. 他の AI モデルやサービスを組み合わせて、機能を強化します。

トラブルシューティング

問題が発生した場合は、以下の一般的な解決策を試してみてください。

• API エラー：キーが正しく設定されていることを確認し、ネットワーク接続が正常であることを確認します。
• ツール呼び出し失敗：パラメータがツールの要件と一致していることを検証し、ツールが正しく登録されていることを確認します。

📄 ライセンス

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

謝辞

• Model Context Protocol：プロトコル仕様を作成してくれました。
• OpenAI：.NET クライアントライブラリを提供してくれました。
• Microsoft：.NET フレームワークとホスティングライブラリをサポートしてくれました。