# nacos-learn-example

**Repository Path**: bytesifter/nacos-learn-example

## Basic Information

- **Project Name**: nacos-learn-example
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-11
- **Last Updated**: 2026-05-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Nacos Learn Example

Nacos MCP 学习生态示例项目——将 [Nacos](https://nacos.io) 作为 MCP Hub，配合 Spring Cloud Alibaba / Spring Cloud AI / MCP Router 构建完整工具调用链路。

> 学习示例（仓库名以 `-example` 结尾），非生产级实现。

## Components

| Component | Description | Port |
|-----------|-------------|------|
| `sca-ai-service` | MCP Hub 管理后端 + Spring AI LLM 编排 | 8082 |
| `sca-service` | 传统 HTTP 微服务（Nacos 服务发现示例） | 8081 |
| `agentic` | Python Agent，LLM 聊天 + MCP 工具调用 | 8000 |
| `agentic-ui` | LLM 聊天 Web 界面 | 5173 |
| `mcp-hub-ui` | MCP Hub 管理面板（服务列表、测试调用） | 5174 |
| `nacos-mcp-router` | 集中式 MCP 协议代理（Docker） | 8083 |
| `mcp-server` | Python MCP 服务端示例（注册在 Nacos MCP Hub） | 8765 |

## Quick Links

- [Architecture](docs/architecture.md)
- [Environment & Variables](docs/environment.md)
- [Quick Start](docs/quickstart.md)
- [Spring AI MCP + Nacos Integration](docs/spring-ai-mcp-nacos.md)

## Project Structure

```
├── agentic/                  # Python Agent (uv, FastAPI)
├── docs/                     # Detailed documentation
├── mcp-hub-ui/               # MCP Hub 管理前端 (Vue 3 + Vite, :5174)
├── mcp-server/               # Python MCP Server 示例 (uv, Nacos 注册)
├── sca-ai-service/           # MCP Hub 后端 + Spring AI (Gradle, :8082)
├── sca-service/              # 传统 HTTP 微服务 (Gradle, :8081)
├── agentic-ui/               # LLM Chat 前端 (Vue 3 + Bun, :5173)
├── nacos-mcp-router/         # MCP Router Docker 部署 + 诊断工具
└── openspec/                 # OpenSpec 项目元数据
```

## OpenSpec

本项目使用 [OpenSpec](https://opencode.ai) 管理工作项和规范。详见 `openspec/` 目录。