CereBro

CereBro 是一个与模型无关的 .Net AI 代理包装器。现在有了 🔥 模型上下文协议 🔥，基于 官方 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 使用控制台作为聊天调度器。 您可以通过实现 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 包，允许您在 Unity 中使用 CereBro。 README。

贡献

如果您想为该项目做出贡献，您可以 fork 该存储库并创建一个 pull request。 如果您发现任何错误或有任何功能请求，您也可以创建一个 issue。

---