MCP Server Example

🚀 MCP サーバーサンプル

このプロジェクトは、.NET を使用して実装された基本的な MCP（モデルコンテキストプロトコル）サーバーを展示しています。MCP クライアントとのやり取りを行うエンドポイントを提供し、MCP モニターなどのテストおよびデバッグツールを統合しています。また、このサンプルでは、ユーザーシークレットを通じて外部サービス（GitLab など）との統合方法も示されています。

🚀 クイックスタート

[!NOTE] GitLab ツール（SearchGroupsAsync）を実行するには、こちらの手順に従ってください。

dotnet build
dotnet run

以下のような出力が表示されます。

正在构建...
info: Microsoft.Hosting.Lifetime[14]
      現在、このアドレスで待機中：http://localhost:5168
info: Microsoft.Hosting.Lifetime[0]
      アプリケーションが起動しました。Ctrl+C で閉じます。
info: Microsoft.Hosting.Lifetime[0]
      ホスト環境：開発

Http URL をコピーしてください。MCP モニターを実行する際に必要になります。

💻 使用例

基本的な使用法

MCP サーバーを実行するには、以下のコマンドを実行します。

dotnet build
dotnet run

高度な使用法

MCP サーバーのテストやデバッグを行うには、MCP モニターを使用できます。

モニターのインストール

ターミナルで以下のコマンドを入力します。

npx @modelcontextprotocol/inspector dotnet run

モニターの起動

以下のような出力が表示されます。

MCP モニターを起動中...
⚙️ プロキシサーバーがポート 6277 で待機中
🔍 MCP モニターが http://127.0.0.1:6274 で起動しました 🚀
New SSE 接続

接続手順

1. 先にコピーした HTTP URL を使用します。
2. 「伝送タイプ」のドロップダウンメニューを選択し、SSE に設定します。
3. この内容を URL テキストボックスに貼り付け（末尾に /sse を追加してください）、接続 ボタンを押します。

利用可能なツールの表示

UI 中央にある ツールの一覧 ボタンを押すと、以下のように表示されます。

これであなたの実験の番です！

🔧 技術詳細

ユーザーシークレット

プロジェクトに <UserSecretsId> がない場合は、以下のコマンドを実行してユーザーシークレットを設定します。

dotnet user-secrets init

GitLab PAT

dotnet user-secrets set "GitLab:Token" "<あなたのトークン値>"

GitLab ドメイン

dotnet user-secrets set "GitLab:domain" "<あなたのドメイン値>"