📢 nacos-sdk-python 3.0.0b1 正式发布 - 新增 AI 客户端功能

# 🎉 nacos-sdk-python 3.0.0b1 正式发布

[中文](#中文) | [English](#english)

---

## 中文

我们很高兴地宣布 **nacos-sdk-python 3.0.0b1** 正式发布！这是一个重大版本更新，带来了显著的新功能和改进。

### 🚀 主要功能

#### AI 客户端支持（新功能）
本次发布最大的亮点是全新的 **AI Client** 功能，为 AI 基础设施提供全面的管理能力：

- **MCP Server 管理**：MCP (Model Context Protocol) 服务器的全生命周期管理
  - 注册、发现和订阅
  - 动态服务发现
  - 端点管理
  
- **Agent Card 管理**：基于 A2A 协议的 AI Agent 完整管理支持
  - Agent 注册和发现
  - 动态端点注册
  - 实时订阅和更新

**要求**：AI Client 功能需要 **Nacos 服务端 3.1.0 或更高版本**。

### 📚 文档

现已提供完整的中英文文档：
- README.md
- README_CN.md

**注意**：3.x 版本的相关代码和文档目前在 `feature/v3` 分支下。

### ⚠️ 破坏性变更

#### 移除 v1 HTTP 协议支持
从 3.0.0 版本开始，我们**移除了对 Nacos v1 HTTP 协议的支持**。这意味着：

- 仅支持 Nacos 3.x 服务端版本
- 使用 v1 协议的应用必须将 Nacos 服务端升级到 3.x
- 所有客户端现在使用更高效的 gRPC 协议

**迁移指南**：在升级此 SDK 之前，请确保您的 Nacos 服务端已升级到 3.x 版本。

### 📦 安装

从 PyPI 安装：
```bash
pip install nacos-sdk-python==3.0.0b1
```

从源码安装（feature/v3 分支）：
```bash
git clone https://github.com/nacos-group/nacos-sdk-python.git
cd nacos-sdk-python
git checkout feature/v3
pip install -e .
```

### 🔧 最低要求

- **Python**: 3.7+
- **Nacos 服务端**: 3.x（AI Client 功能需要 3.1.0+）

### 📖 快速开始

#### 配置中心客户端
```python
from v2.nacos import NacosConfigService, ClientConfigBuilder

client_config = ClientConfigBuilder().server_address('localhost:8848').build()
config_client = await NacosConfigService.create_config_service(client_config)
```

#### 注册中心客户端
```python
from v2.nacos import NacosNamingService, ClientConfigBuilder

client_config = ClientConfigBuilder().server_address('localhost:8848').build()
naming_client = await NacosNamingService.create_naming_service(client_config)
```

#### AI 客户端（新功能）
```python
from v2.nacos import NacosAIService, ClientConfigBuilder

client_config = ClientConfigBuilder().server_address('localhost:8848').build()
ai_client = await NacosAIService.create_ai_service(client_config)

# MCP Server 管理
mcp_server = await ai_client.get_mcp_server(
    GetMcpServerParam(mcp_name='my-mcp-server', version='1.0.0')
)

# Agent Card 管理
agent_card = await ai_client.get_agent_card(
    GetAgentCardParam(agent_name='my-agent', version='1.0.0')
)
```

### 🤝 反馈

这是一个 beta 版本。我们欢迎您的反馈和问题报告！

- 问题反馈: https://github.com/nacos-group/nacos-sdk-python/issues
- 讨论区: https://github.com/nacos-group/nacos-sdk-python/discussions

### 🙏 贡献者

感谢所有为此版本做出贡献的开发者！

---

## English

We are excited to announce the release of **nacos-sdk-python 3.0.0b1**! This is a major version update that brings significant new features and improvements.

### 🚀 Major Features

#### AI Client Support (NEW)
The biggest highlight of this release is the new **AI Client** functionality, providing comprehensive management capabilities for AI infrastructure:

- **MCP Server Management**: Full lifecycle management for MCP (Model Context Protocol) servers
  - Registration, discovery, and subscription
  - Dynamic service discovery
  - Endpoint management
  
- **Agent Card Management**: Complete support for AI Agent management based on A2A protocol
  - Agent registration and discovery
  - Dynamic endpoint registration
  - Real-time subscription and updates

**Requirements**: AI Client features require **Nacos server 3.1.0 or above**.

### 📚 Documentation

Complete documentation is now available in both English and Chinese:
- README.md
- README_CN.md

**Note**: The code and documentation for version 3.x are currently in the `feature/v3` branch.

### ⚠️ Breaking Changes

#### Removed v1 HTTP Protocol Support
Starting from version 3.0.0, we have **removed support for Nacos v1 HTTP protocol**. This means:

- Only supports Nacos 3.x server versions
- Applications using v1 protocol must upgrade their Nacos server to 3.x
- All clients now use the more efficient gRPC protocol

**Migration Guide**: Please ensure your Nacos server is upgraded to version 3.x before upgrading this SDK.

### 📦 Installation

Install from PyPI:
```bash
pip install nacos-sdk-python==3.0.0b1
```

Install from source (feature/v3 branch):
```bash
git clone https://github.com/nacos-group/nacos-sdk-python.git
cd nacos-sdk-python
git checkout feature/v3
pip install -e .
```

### 🔧 Minimum Requirements

- **Python**: 3.7+
- **Nacos Server**: 3.x (3.1.0+ for AI Client features)

### 📖 Quick Start

#### Config Client
```python
from v2.nacos import NacosConfigService, ClientConfigBuilder

client_config = ClientConfigBuilder().server_address('localhost:8848').build()
config_client = await NacosConfigService.create_config_service(client_config)
```

#### Naming Client
```python
from v2.nacos import NacosNamingService, ClientConfigBuilder

client_config = ClientConfigBuilder().server_address('localhost:8848').build()
naming_client = await NacosNamingService.create_naming_service(client_config)
```

#### AI Client (NEW)
```python
from v2.nacos import NacosAIService, ClientConfigBuilder

client_config = ClientConfigBuilder().server_address('localhost:8848').build()
ai_client = await NacosAIService.create_ai_service(client_config)

# MCP Server Management
mcp_server = await ai_client.get_mcp_server(
    GetMcpServerParam(mcp_name='my-mcp-server', version='1.0.0')
)

# Agent Card Management
agent_card = await ai_client.get_agent_card(
    GetAgentCardParam(agent_name='my-agent', version='1.0.0')
)
```

### 🤝 Feedback

This is a beta release. We welcome your feedback and bug reports!

- Issues: https://github.com/nacos-group/nacos-sdk-python/issues
- Discussions: https://github.com/nacos-group/nacos-sdk-python/discussions

### 🙏 Contributors

Thanks to all contributors who made this release possible!

---

📢 nacos-sdk-python 3.0.0b1 正式发布 - 新增 AI 客户端功能 #269

Description

🎉 nacos-sdk-python 3.0.0b1 正式发布

中文

🚀 主要功能

AI 客户端支持（新功能）

📚 文档

⚠️ 破坏性变更

移除 v1 HTTP 协议支持

📦 安装

🔧 最低要求

📖 快速开始

配置中心客户端

注册中心客户端

AI 客户端（新功能）

🤝 反馈

🙏 贡献者

English

🚀 Major Features

AI Client Support (NEW)

📚 Documentation

⚠️ Breaking Changes

Removed v1 HTTP Protocol Support

📦 Installation

🔧 Minimum Requirements

📖 Quick Start

Config Client

Naming Client

AI Client (NEW)

🤝 Feedback

🙏 Contributors

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions