Monkey

🚀 猿 - モデルコンテキストプロトコル（MCP）サーバ

このサーバは、.NET 9.0 を使用して実装されたモデルコンテキストプロトコル（MCP）サーバです。MCP サーバは、モデルベースのシステム内の各コンポーネント間の通信を可能にするプロトコルを提供します。この実装では、カスタムツールとサービスを使用して基本的な MCP サーバを設定する方法を示しています。

🚀 クイックスタート

VS Code での設定（GitHub Copilot、Claude デスクトップ、または他の MCP クライアントを使用）：

{
    "inputs": [],
    "servers": {
        "monkeymcp": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "jamesmontemagno/monkeymcp"
            ],
            "env": {}
        }
    }
}

✨ 主な機能

コアコンポーネント

• MCP サーバ：ModelContextProtocol ライブラリ（バージョン 0.1.0-preview.2）を使用して構築されています。
• 標準入出力伝送：stdio を介してクライアントと通信します。
• カスタムツール統合：MCP ツールの作成と登録のサンプルが含まれています。

サービス

• MonkeyService：API エンドポイントから猿のデータを取得するサンプルサービスです。
  • 利用可能なすべての猿を取得するか、名前で特定の猿の情報を検索するメソッドを提供します。
  • パフォーマンス向上のためのキャッシュ機能を備えています。

利用可能なツール

サーバは、クライアントが呼び出すことができるいくつかのツールを公開しています。

猿ツール

• GetMonkeys：JSON シリアル化されたすべての猿のリストを返します。
• GetMonkey：名前に基づいて特定の猿の情報を取得します。

エコーツール

• Echo：提供されたメッセージをエコーし、先頭に「hello」を付けます。

📦 インストール

ホスト構成

サーバは、Microsoft.Extensions.Hosting（バージョン 9.0.3）を使用して構成されています。

• 複数のソース（JSON、環境変数、コマンドライン）から構成を読み込むことができます。
• 依存性注入サービスを提供する機能があります。
• ログ記録機能を備えています。

ログプロバイダオプション

いくつかのログプロバイダが利用可能です。

• コンソール：標準出力に出力します。
• デバッグ：デバッグ目的のログです。
• ファイル：ログをファイルに書き込みます。
• イベントソース：イベントソースを介してログを記録します。

実行方法

ターミナルウィンドウで以下のコマンドを実行して、MCP サーバを起動します。

dotnet run --project ./MCP/Server.csproj

サーバ機能の拡張

より高度な機能が必要な場合は、以下のガイドを参照してください。

クライアント構成例（C#）

var configuration = new ConfigurationBuilder()
    .AddJsonFile("client.json")
    .Build();

var mcpClient = new McpClient(configuration);
await mcpClient.StartAsync();

📚 ドキュメント

プロジェクト構造

• MonkeyService.cs：猿のデータを取得するサービスを実装しています。
• MonkeyTools.cs：猿のデータにアクセスするための MCP ツールです。
• Program.cs：MCP サーバを構成して起動するエントリポイントです。

依存関係

• Microsoft.Extensions.Hosting（9.0.3）：ホストインフラストラクチャを提供します。
• ModelContextProtocol（0.1.0-preview.2）：MCP サーバの実装です。
• System.Text.Json（9.0.3）：JSON のシリアル化と逆シリアル化に使用されます。

📄 ライセンス

このプロジェクトは MIT License の下で利用可能です。