# RedNb Nacos

> 面向 Nacos 3.2.4 的 .NET 8/10 SDK，提供配置中心、服务注册与发现、ASP.NET Core 集成及 AI Registry（MCP、A2A、Prompt、Skill、AgentSpec）。

- **Type:** MCP server
- **Install:** `agentstack add mcp-yinghongzhen-rednb-nacos`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [yinghongzhen](https://agentstack.voostack.com/s/yinghongzhen)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [yinghongzhen](https://github.com/yinghongzhen)
- **Source:** https://github.com/yinghongzhen/RedNb.Nacos
- **Website:** https://github.com/yinghongzhen/RedNb.Nacos/releases

## Install

```sh
agentstack add mcp-yinghongzhen-rednb-nacos
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# RedNb.Nacos

[](https://www.nuget.org/packages/RedNb.Nacos.All/)
[](https://github.com/yinghongzhen/RedNb.Nacos/releases/latest)
[](docs/CAPABILITIES.md)
[](docs/TEST_REPORT.md)

[English](README.en.md) | 简体中文

面向 Nacos 3.2.4 的 .NET 8 / .NET 10 SDK。配置和服务发现默认使用 gRPC；AI 与管理操作按服务器实际能力选择 HTTP Client、Admin 或 Console 通道。

当前稳定版 **2.0.0** 已发布到 [NuGet.org](https://www.nuget.org/packages/RedNb.Nacos.All/2.0.0) 和 [GitHub Release](https://github.com/yinghongzhen/RedNb.Nacos/releases/tag/v2.0.0)。SDK 版本为 2.0.0，服务端验收版本为 Nacos 3.2.4。

从 1.x 升级包含命名空间和默认实现的破坏性调整，请先阅读[迁移说明](docs/MIGRATION.md)。**不支持 Nacos 2.x**；其他 3.x 小版本的支持范围见[能力矩阵](docs/CAPABILITIES.md)。

## 安装

普通 .NET 应用推荐安装依赖注入包：

```bash
dotnet add package RedNb.Nacos.DependencyInjection --version 2.0.0
```

ASP.NET Core 应用需要配置热更新、健康检查和服务注册时，安装：

```bash
dotnet add package RedNb.Nacos.AspNetCore --version 2.0.0
```

需要全部组件时，可安装聚合包：

```bash
dotnet add package RedNb.Nacos.All --version 2.0.0
```

上述包会自动引入所需依赖，无需把六个包全部手动添加。

## 选择类库

| NuGet 包 | 当前版本 | 用途 |
| --- | --- | --- |
| [RedNb.Nacos](https://www.nuget.org/packages/RedNb.Nacos/2.0.0) | 2.0.0 | 接口、模型、选项和公共功能 |
| [RedNb.Nacos.Http](https://www.nuget.org/packages/RedNb.Nacos.Http/2.0.0) | 2.0.0 | 显式 HTTP 客户端和 v3 管理接口 |
| [RedNb.Nacos.Grpc](https://www.nuget.org/packages/RedNb.Nacos.Grpc/2.0.0) | 2.0.0 | 配置、服务发现、原生锁和 AI 组合客户端 |
| [RedNb.Nacos.DependencyInjection](https://www.nuget.org/packages/RedNb.Nacos.DependencyInjection/2.0.0) | 2.0.0 | 推荐的 DI 注册入口、命名客户端 |
| [RedNb.Nacos.AspNetCore](https://www.nuget.org/packages/RedNb.Nacos.AspNetCore/2.0.0) | 2.0.0 | IConfiguration 热更新、健康检查、服务注册 |
| [RedNb.Nacos.All](https://www.nuget.org/packages/RedNb.Nacos.All/2.0.0) | 2.0.0 | 纯依赖聚合包，方便体验全部组件 |

## 推荐用法

```csharp
using Microsoft.Extensions.DependencyInjection;
using RedNb.Nacos.DependencyInjection;
using RedNb.Nacos.Config;

var services = new ServiceCollection();
services.AddNacos(options =>
{
    options.ServerAddresses = Environment.GetEnvironmentVariable("NACOS_SERVER") ?? "localhost:8848";
    options.ConsoleAddresses = Environment.GetEnvironmentVariable("NACOS_CONSOLE") ?? "localhost:8080";
    options.Username = Environment.GetEnvironmentVariable("NACOS_USERNAME");
    options.Password = Environment.GetEnvironmentVariable("NACOS_PASSWORD");
});
await using var provider = services.BuildServiceProvider();
var config = provider.GetRequiredService();
var content = await config.GetConfigAsync("app-config", "DEFAULT_GROUP", 5000);
```

只需配置或服务发现时，可使用 `AddNacosConfig` / `AddNacosNaming`。AI 通过 `AddNacosAi` 单独启用，命名空间管理通过 `AddNacosAdministration` 单独启用。各模块延迟创建，不会因为注册基础服务就连接 AI 或锁模块。

多个 Nacos 环境使用 `services.AddNacos("environment-name", configure)`，再通过 `GetRequiredKeyedService("environment-name")` 获取。不同名称的客户端和缓存相互隔离。

不使用 DI 时可用 `NacosGrpcFactory.CreateConfigServiceAsync(options)`、`CreateNamingServiceAsync(options)`；AI 推荐 `new NacosAiClient(options)`，不需要调用者自行组合两种通道。具体使用见 [samples](samples/README.md)。

## 环境和验证

- API 端口默认 8848，客户端 gRPC 默认 9848，控制台默认 8080；显式映射不同端口时请配置地址和 GrpcPortOffset。
- 默认鉴权使用用户名密码/token。默认 Nacos 插件不提供本 SDK 旧版本假设的 AK/SK 登录接口。
- [单机 Docker 部署](deploy/docker-compose/README.md)
- [构建和集成测试](docs/ENVIRONMENT_BOOTSTRAP.md)
- [完整改进计划](docs/IMPROVEMENT_PLAN.md)
- [测试报告](docs/TEST_REPORT.md)
- [文档索引](docs/README.md)

## 能力边界

纯 HTTP 配置监听和 Fuzzy Watch 会明确报不支持；使用推荐 gRPC 入口。MCP/Agent Console 操作在 3.2.4 上限定 public 空间。旧 Maintainer 接口保留迁移错误提示，不再发送 v1/v2 请求；已实现的新管理功能以能力矩阵为准。原生锁是服务器互斥原语，不提供 fencing 或可重入语义。

源码按 Apache-2.0 发布，见 [LICENSE](LICENSE)。感谢 [Nacos](https://github.com/alibaba/nacos) 社区。

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [yinghongzhen](https://github.com/yinghongzhen)
- **Source:** [yinghongzhen/RedNb.Nacos](https://github.com/yinghongzhen/RedNb.Nacos)
- **License:** Apache-2.0
- **Homepage:** https://github.com/yinghongzhen/RedNb.Nacos/releases

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-yinghongzhen-rednb-nacos
- Seller: https://agentstack.voostack.com/s/yinghongzhen
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.