CereBro

CereBro

CereBro は、.Net 用のモデルに依存しない AI エージェントラッパーです。🔥 Model Context Protocol 🔥 に対応し、公式 C# SDK をベースとしているため、コードを変更せずに、さまざまな AI モデルで使用できるツールを作成できます。

モデル

CereBro でサポートされているモデルと、今後サポート予定のモデルを以下に示します。

サポート済み：

• OpenAI

サポート予定：

• Claude
• Grok
• DeepSeek
• Gemini
• Ollama

インストール

以下のコマンドを使用して、NuGet からパッケージをインストールできます。

dotnet add package Rob1997.CereBro

dotnet add package Rob1997.CereBro.Open-AI

使い方

ステップ 1：servers.json ファイルを作成する

このファイルには、使用する MCP サーバーの構成を記述します。以下に servers.json ファイルの例を示します。

[
  {
    "Id": "everything-server",
    "Name": "Everything",
    "TransportType": "stdio",
    "TransportOptions": {
      "command": "npx",
      "arguments": "-y @modelcontextprotocol/server-everything"
    }
  }
]

その他のサーバーについてはこちらをご覧ください。

ステップ 2：OpenAI API キーを環境変数に追加する

export OPEN_AI_API_KEY="your-api-key"

$env:OPEN_AI_API_KEY="your-api-key"

この設定を永続化する場合は、Linux の .bashrc または .bash_profile ファイルに追加するか、PowerShell で以下のコマンドを実行してください。

[Environment]::SetEnvironmentVariable("OPEN_AI_API_KEY", "your-api-key", "User")

ステップ 3：以下のコードを Program.cs（エントリーポイント）に追加する

public static async Task Main(string[] args)
{
    var builder = Host.CreateApplicationBuilder(args);
    
    builder.Services.UseOpenAI(Environment.GetEnvironmentVariable("OPEN_AI_API_KEY"), "gpt-4o-mini");
            
    IHost cereBro = builder.BuildCereBro(new CereBroConfig{ ServersFilePath = "./servers.json" });

    await cereBro.RunAsync();
}

CereBro は Console をチャットディスパッチャーとして使用します。独自のディスパッチャーを作成するには、IChatDispatcher インターフェイスを実装し、builder.BuildCereBro<IChatDispatcher>(config) を使用して CereBro のホストを構築します。

ステップ 4：アプリケーションを実行する

dotnet run

新しいモデルの追加

現在、CereBro がサポートしているのは OpenAI のモデルのみです。新しいモデルを追加するには、Microsoft.Extensions.AI.IChatClient を実装する必要があります。すでに実装が存在する場合は不要です。Microsoft は OpenAI や Ollama など、一部のモデル向けの実装をすでに提供しています。

その後、こちらのように、Microsoft.Extensions.AI.FunctionInvokingChatClient を実装するプレースホルダー型を作成できます。

最後に、UseChatClient<T>(this IServiceCollection services, IChatClient chatClient) where T : FunctionInvokingChatClient 拡張メソッドを使用して、サービスコレクションにモデルを追加できます。

⚠️ 注意 ⚠️

現在、CereBro は複数のモデルを同時にサポートしていないため、別のモデルを使用するには Program.cs ファイルから UseOpenAI メソッドを削除する必要があります。

CereBro.Unity

CereBro.Unity は、Unity で CereBro を使用できるようにする Unity パッケージです。README。

コントリビューション

このプロジェクトに貢献する場合は、リポジトリをフォークしてプルリクエストを作成してください。バグを見つけた場合や機能のリクエストがある場合は、Issue を作成することもできます。

---