Skip to content

feat: update nacos-gateway-mcp.md with SAA Distributed MCP Client usage #271

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
GTyingzi merged 6 commits into from
Feb 24, 2026
Merged

feat: update nacos-gateway-mcp.md with SAA Distributed MCP Client usage #271

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
32956e1
feat: update nacos-gateway-mcp.md with SAA Distributed MCP Client usa…
vera-qwang Feb 15, 2026
1de1cdb
fix: markdown lint errors
vera-qwang Feb 19, 2026
0a4f92c
Apply suggestions from code review
vera-qwang Feb 19, 2026
71af19c
fix: github action eslint not found error
vera-qwang Feb 20, 2026
ab00684
chore(docs): add missed ignored words to codespell config
vera-qwang Feb 20, 2026
f70bab5
fix(docs): resolve broken links in versions page
vera-qwang Feb 20, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .github/workflows/build.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,7 @@ jobs:
- name: Lint Checks
run: |
make install-tools
make install
make lint
build:
name: Build
Expand Down
25 changes: 12 additions & 13 deletions blog/saa-agentscope-announcement.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,13 +14,13 @@

Spring AI 的核心目标是连接企业的数据和 API 与 AI 模型，简化 AI 集成。包含模型接入、函数调用、MCP 调用和发现、对话记忆和 RAG、可观测等功能。Spring AI Alibaba 在其基础之上做了非常多的探索，包括：

* Spring AI Extensions：将 Spring AI 的能力和阿里云的模型、工具、RAG、异步消息、网关、可观测等云原生基础设施进行了适配，并提供了最佳实践。
* Spring AI Extensions：将 Spring AI 的能力和阿里云的模型、工具、RAG、异步消息、网关、可观测等云原生基础设施进行了适配，并提供了最佳实践。

* Spring AI Alibaba Graph：提供 Agentic、Multi-Agent 编排能力，包括 SupervisorAgent、SequentialAgent、LoopAgent 等，内置上下文工程、Human In The Loop 等核心能力。
* Spring AI Alibaba Graph：提供 Agentic、Multi-Agent 编排能力，包括 SupervisorAgent、SequentialAgent、LoopAgent 等，内置上下文工程、Human In The Loop 等核心能力。

* Spring AI Alibaba Graph：侧重 Workflow 形态的工作流编排，在很多企业级业务场景实现了规模化落地。
* Spring AI Alibaba Graph：侧重 Workflow 形态的工作流编排，在很多企业级业务场景实现了规模化落地。

* Spring AI Alibaba Admin：是我们在 Agent 开发提效方面的一类探索，包含了提示词维护、可观测、评估，其中，提示词维护是基于 Nacos，可观测能力建设则是基于 LoongSuite。
* Spring AI Alibaba Admin：是我们在 Agent 开发提效方面的一类探索，包含了提示词维护、可观测、评估，其中，提示词维护是基于 Nacos，可观测能力建设则是基于 LoongSuite。

在开源的过程中，我们逐步观察到，开放框架呈现出两种不同的发展趋势。一种是以 Spring AI Alibaba 为代表的，以 Graph 为核心设计理念的应用框架，强调工作流编排在 AI 应用开发过程中的重要性。一种是 AgentScope 为代表的，以 Agentic 为核心设计理念的应用框架，最大化利用基础大模型的能力。

Expand All @@ -32,14 +32,13 @@ Spring AI 的核心目标是连接企业的数据和 API 与 AI 模型，

AgentScope 是由阿里巴巴通义实验室在2024年2月开源的多智能体开发框架，旨在为开发者提供一种简单、高效、可扩展的方式来构建基于大语言模型的智能体应用。AgentScope 的架构主要包括三层：核心框架 (Agent 构建与编排)、Runtime (安全运行时)、Studio (可视化监控与评估)。AgentScope 拥有强大的算法和工程团队，面向全球开发者提供开源服务。其中，截止v1.0.7，核心框架仓库已发布21个版本，获得1.5w star。

* GitHub：[https://github.com/agentscope-ai/](https://github.com/agentscope-ai/agentscope)
* GitHub：[https://github.com/agentscope-ai/](https://github.com/agentscope-ai/agentscope)

* 官网：[https://agentscope.io/](https://agentscope.io/)
* 官网：[https://agentscope.io/](https://agentscope.io/)

* Disord：[https://discord.gg/Rnf2JCSKZp](https://discord.gg/Rnf2JCSKZp)

* 钉钉群：105130040570
* Disord：[https://discord.gg/Rnf2JCSKZp](https://discord.gg/Rnf2JCSKZp)

* 钉钉群：105130040570

AgentScope-Java 是我们和 AgentScope 共同推出的面向 Java 开发群体智能体开发框架，同时共享以上社区资源，Java 开发者们若遇到使用问题，可以通过以上方式联系到我们。

Expand All @@ -61,11 +60,11 @@ AgentScope 是一个以 Agentic 为核心设计理念的应用框架，提供

是的，会持续投入的。主要体现在以下两个方向：

* 跟进 Spring AI 的演进，持续发版解决企业应用过程中遇到的问题。
* 跟进 Spring AI 的演进，持续发版解决企业应用过程中遇到的问题。

* 对底层进行升级，支持 AgentScope，做好阿里云、AgentScope 与 Spring 生态连接，提供企业级智能体解决方案。
* 对底层进行升级，支持 AgentScope，做好阿里云、AgentScope 与 Spring 生态连接，提供企业级智能体解决方案。

* 全面升级 Admin 平台，打造企业级 Agent 构建与交付平台。
* 全面升级 Admin 平台，打造企业级 Agent 构建与交付平台。

![admin](/img/blog/saa-agentscope/img_4.png)

Expand All @@ -77,4 +76,4 @@ AgentScope Java 自 2025 年 9 月开源（[https://github.com/agentscope-

在技术演进层面，我们正持续探索更高效、智能的上下文工程与多 Agent 协同范式，致力于支撑更强大的 AI 应用构建。 此外，针对 Agent 流量呈现的“二八定律”特征（头部 20% 的 Agent 承载了 80% 的流量），我们在架构上全力推进 Serverless 化，通过实现毫秒级冷启动与混合部署，帮助开发者在应对高并发的同时，显著降低部署成本并提升效率。

![admin](/img/blog/saa-agentscope/img_5.png)
![admin](/img/blog/saa-agentscope/img_5.png)
43 changes: 22 additions & 21 deletions docs/versions.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -36,20 +36,20 @@ keywords: [版本, versions, releases, Spring AI Alibaba, Spring AI 版本适配
<type>pom</type>
<scope>import</scope>
</dependency>
<dependency>
<groupId>org.springframework.ai</groupId>
<artifactId>spring-ai-bom</artifactId>
<version>1.1.2</version>
<type>pom</type>
<scope>import</scope>
</dependency>
<dependency>
<groupId>com.alibaba.cloud.ai</groupId>
<artifactId>spring-ai-alibaba-extensions-bom</artifactId>
<version>1.1.2.1</version>
<type>pom</type>
<scope>import</scope>
</dependency>
<dependency>
<groupId>org.springframework.ai</groupId>
<artifactId>spring-ai-bom</artifactId>
<version>1.1.2</version>
<type>pom</type>
<scope>import</scope>
</dependency>
<dependency>
<groupId>com.alibaba.cloud.ai</groupId>
<artifactId>spring-ai-alibaba-extensions-bom</artifactId>
<version>1.1.2.1</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencyManagement>

<dependencies>
Expand All @@ -58,11 +58,12 @@ keywords: [版本, versions, releases, Spring AI Alibaba, Spring AI 版本适配
<artifactId>spring-ai-alibaba-agent-framework</artifactId>
</dependency>
<dependency>
<groupId>com.alibaba.cloud.ai</groupId>
<artifactId>spring-ai-alibaba-starter-dashscope</artifactId>
</dependency>
<groupId>com.alibaba.cloud.ai</groupId>
<artifactId>spring-ai-alibaba-starter-dashscope</artifactId>
</dependency>
</dependencies>
```

---

## 组件与生态版本
Expand Down Expand Up @@ -115,11 +116,11 @@ keywords: [版本, versions, releases, Spring AI Alibaba, Spring AI 版本适配
|------|-------------|------|
| **入门** | [概览](overview.md) | 项目定位、架构、核心能力与安装方式 |
| | [快速开始](quick-start.md) | 从零搭建 ReactAgent，含环境、依赖、API Key、示例代码 |
| **Agent 框架教程** | [frameworks/agent-framework/tutorials/](frameworks/agent-framework/tutorials/) | Agents、Models、Tools、Hooks、Memory、Messages、Skills、Structured Output 等 |
| **Agent 框架进阶** | [frameworks/agent-framework/advanced/](frameworks/agent-framework/advanced/) | RAG、多智能体、人机协同、上下文工程、A2A、Workflow 等 |
| **Agent 框架教程** | [frameworks/agent-framework/tutorials/](frameworks/agent-framework/tutorials/agents.md) | Agents、Models、Tools、Hooks、Memory、Messages、Skills、Structured Output 等 |
| **Agent 框架进阶** | [frameworks/agent-framework/advanced/](frameworks/agent-framework/advanced/context-engineering.md) | RAG、多智能体、人机协同、上下文工程、A2A、Workflow 等 |
| **Graph 核心** | [frameworks/graph-core/quick-start.md](frameworks/graph-core/quick-start.md) | Graph 快速上手 |
| | [frameworks/graph-core/core/](frameworks/graph-core/core/) | 核心库、持久化、内存、流式等 |
| | [frameworks/graph-core/examples/](frameworks/graph-core/examples/) | 子图、并行、取消、MCP、持久化、人机协同等示例 |
| | [frameworks/graph-core/core/](frameworks/graph-core/core/core-library.md) | 核心库、持久化、内存、流式等 |
| | [frameworks/graph-core/examples/](frameworks/graph-core/examples/llm-streaming-springai.md) | 子图、并行、取消、MCP、持久化、人机协同等示例 |
| **Studio** | [frameworks/studio/quick-start.md](frameworks/studio/quick-start.md) | Studio 嵌入式调试与使用 |

---
Expand Down
51 changes: 51 additions & 0 deletions integration/mcps/nacos/nacos-gateway-mcp.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -69,8 +69,43 @@ _ _streamable-http:
- 根据 restful 接口响应，选择响应模版
![nacos-gateway-1](/img/blog/extensions/mcp/nacos-gateway-1.png)

### 使用SAA Distributed MCP Client连接

使用`spring-ai-alibaba-starter-mcp-distributed`的客户端连接需要依赖nacos中注册的服务信息，由于存量转换类型的MCP在nacos中维护的服务信息是对应的 restful 服务而不是mcp服务，因此无法直接通过在Distributed MCP Client中配置这个存量服务进行连接，而是需要连接到gateway。

需要注意gateway模块默认不会注册为nacos的mcp服务和实例，因此需要将gateway注册为nacos的MCP服务。注册方式为在gateway项目的`pom.xml`中引入`spring-ai-alibaba-starter-mcp-registry`依赖。
```xml
<dependency>
<groupId>com.alibaba.cloud.ai</groupId>
<artifactId>spring-ai-alibaba-starter-mcp-registry</artifactId>
Comment thread
vera-qwang marked this conversation as resolved.
<version>${spring-ai-extensions.version}</version>
</dependency>
```

同时需要修改`application.yml`配置文件，在spring.ai.alibaba.mcp.nacos下新增register配置项
```yaml
spring:
ai:
alibaba:
# MCP Gateway 配置
mcp:
gateway:
...
# Nacos 注册中心配置
nacos:
server-addr: localhost:8848
namespace: public
Comment thread
vera-qwang marked this conversation as resolved.
username: nacos
password: nacos
register:
enabled: true
service-group: mcp-server ## 指定分组名称
service-name: mcp-nacos-gateway-example ## 指定服务名称
```

## 验证

### 使用普通MCP Client
启动 gateway 服务，我们发现 restful 服务的工具已经被添加了

![nacos-gateway-2](/img/blog/extensions/mcp/nacos-gateway-2.png)
Expand All @@ -86,3 +121,19 @@ Gateway 被触发调用 restful 服务
restful 接收请求

![nacos-gateway-5](/img/blog/extensions/mcp/nacos-gateway-5.png)

### 使用SAA Distributed MCP Client

启动gateway服务，可以看到gateway已经通过registry模块自动注册为nacos服务，endpoint 信息也已经正确注册

![nacos-gateway-registry-nacos-1](/img/blog/extensions/mcp/nacos-gateway-registry-nacos-1.png)
![nacos-gateway-registry-nacos-2](/img/blog/extensions/mcp/nacos-gateway-registry-nacos-2.png)

启动一个Distributed MCP Client 连接 Gateway 提供的 MCP 服务，触发时间工具

Comment thread
vera-qwang marked this conversation as resolved.
![nacos-gateway-6](/img/blog/extensions/mcp/nacos-gateway-6.png)

Gateway 被触发调用 restful 服务

![nacos-gateway-7](/img/blog/extensions/mcp/nacos-gateway-7.png)

Binary file added static/img/blog/extensions/mcp/nacos-gateway-6.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/blog/extensions/mcp/nacos-gateway-7.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/blog/extensions/mcp/nacos-gateway-registry-nacos-1.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/blog/extensions/mcp/nacos-gateway-registry-nacos-2.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
3 changes: 3 additions & 0 deletions tools/linter/codespell/.codespell.ignorewords
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,3 +5,6 @@ exmaple
ois
dialin
NIN

nin
toi
2 changes: 1 addition & 1 deletion tools/make/Makefile.core.mk
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -101,7 +101,7 @@ checklinks: ## Check for broken links in the docs

.PHONY: lint
lint: ## Run all lint checks
lint: markdown yamllint npm-lint pangu-lint yamllint codespell
lint: markdown yamllint npm-lint pangu-lint codespell
@echo "All lint checks passed!"

.PHONY: npm-lint
Expand Down
Loading