This release focuses on enhancing the MCP and A2A (Agent-to-Agent) capabilities of Nacos, improving system stability, and refining security and configuration management. Key additions include support for batch registration of agent endpoints, merging versions during MCP server import, and enhanced flexibility in updating MCP servers with an overrideExisting option. The release also introduces default security configuration support for both inbound and outbound communication, laying the foundation for secure AI agent interactions.

Detail changes in this version are listed below:

Feature

[#13867] Support override existing configuration when updating MCP server.
[#13922] Add thread pool configuration to allow core thread timeout.
[#13946] Refactor AgentEndpoint model and add new fields to support advanced protocol and queries.
[#13953] Add support for default security configurations, including selection and setup for inbound and outbound security schemes.
[#13957] Support batch registration of agent endpoints.
[#13951] Add configurable CORS filter for console module.

Enhancement/Refactor

[#13822] Separate responsibilities between client executor and login scheduled executor to prevent thread pool exhaustion.
[#13863] Optimize shutdown.sh script to combine multiple PIDs into a single line for cleaner process termination.
[#13911] Enhance importToolsFromMcp API to support streamable protocol servers.
[#13914] Upgrade checkStyle plugin version to improve code linting and maintainability.
[#13945] Support merging versions when importing MCP server specifications.
[#13963] Refactor List config apis to support return configTags and desc.

BugFix

[#13140] Fix consistent namespace handling for ConfigChangeNotifyRequest when client namespace is empty.
[#13860] Fix potential null pointer exception risk in ConfigMigrateService.
[#13866] Fix inability to edit imported MCP servers in the console.
[#13869] Fix error creating bean 'consoleHealthController' due to missing dependency injection.
[#13877] Fix namespaceId issue in McpRemoteHandler causing incorrect context propagation.
[#13882] Fix synchronization lock and add volatile keyword for TpsControlManager to ensure thread safety.
[#13884] Fix JSON parsing error in MCP server validation API during import.
[#13902] Fix deprecated Log4j2 package scanning warnings by updating logger initialization logic.
[#13948] Fix failure when updating agent card through the console interface.
[#13959] Fix Password update fails when deployed with independent console/server.
[#13964] Fix when nacos.extension.ai.enabled is false, nacos start failed.

Dependencies

[#13879] Add unit tests for AI-related components.
[#13881] Add utility APIs for development and testing purposes.

Deployment Required

New Contributors

• @bee0511 made their first contribution in #13858
• @Alioth4J made their first contribution in #13864
• @five111 made their first contribution in #13861
• @herodotus-ecosystem made their first contribution in #13872
• @wanna280 made their first contribution in #13882
• @zhan7236 made their first contribution in #13966
• @aihai made their first contribution in #13965

Full Changelog: 3.1.0-bugfix...3.1.1

This version is mainly do some enhancement and fix some bugs from 2.5.1.

Please see the details of the changes below:

Change details

Enhancement&Refactor

[#12102] Fix deprecated Log4j2 package scanning warnings.
[#13183] Add grpc client request metrics switch.
[#13234] Make the IP input box in Listening Query be required.
[#13297] Add build-helper-maven-plugin to support IDEA auto-recognize generated sources.

BugFix

[#12484] Fix ConfigController.stopBeta srcUser param is null.
[#13171] Fix the full regular dump for gray configuration.
[#13193] Fix Configuration database health check sql for mysql and derby plugin.
[#13218] Fix naming v1 catalog page service api return all datum when pageSize is large.
[#13223] Fix the permission problem of ip dimension query configuration monitoring.
[#13229] Fix the config tag being lost during configuration export.
[#13249] Fix configuration change plugin return incompatibility.
[#13273] Fix create cluster client don't effect fpr nacos.remote.client.grpc config problem.
[#13400] Fix naming subscriber get appName is - problem.
[#13614] Fix namespace conversion bug for default namespaceId from `` to public.
[#13629] Fix NPE problem when update instance metadata with null value.
[#13716] Fix namespaceId has no default value in the oracle database plugin.
[#13744] Fix CONFIG_INFO_GRAY_WRAPPER_ROW_MAPPER not registered to database plugin.

Dependency

[#13183] Bump tomcat-embed-core to 9.0.99.
[#13454] Upgrade nacos-logback-adapter to 1.1.4.

New Contributors

• @psxjoy made their first contribution in #13204
• @linwumingshi made their first contribution in #13222
• @chunhai1127 made their first contribution in #13235
• @zhilu-tang made their first contribution in #13298
• @kuchikij made their first contribution in #13716

Full Changelog: 2.5.1...2.5.2

During the release of Nacos 3.1.0, the MCP official team published a new version of the registry protocol (2025-09-16). Nacos 3.1.0 has swiftly completed adaptation to this protocol. To utilize this feature, please download the latest Nacos 3.1.0 release package and Docker images.

This version is a new millstone version and fix some bugs from 3.1.0-BETA.

In 3.1.0, Nacos follow the new MCP official registry protocol. All users can use Nacos as the MCP official registry private deployment to build their own private market or registry for MCP servers.
Nacos also support to import MCP server by MCP server spec json and support auto get tools by mcp url, These two new feature will improve usage for users to create MCP server into Nacos.
And also, this version support user enabled/disabled MCP server in console and support encrypt mcp tools schemes for storage with configuration encrypt plugin.

What's more, in this version Nacos support A2A registry which can allow users or agent framework like Spring AI Alibaba to publish and discovery AgentCard and agent endpoint. Current only support discovery by name of agent. Nacos will support discovery by skills, tags or descriptions in future.

Other Changes are to fix many bugs found before versions and do some dependencies upgrading.

There is one block change from 3.1.0-BETA. If you upgrade version from 3.1.0-BETA, Please delete all AgentCards before upgrading, or delete all configuration group with agent and agent-version after upgraded. And do re-publish for AgentCards. If Upgrade from other versions can ignore it.

Detail Changes in 3.1.0 see:

Feature

[#12191] Add namespace existence check.
[#13322] Support A2A registry.
[#13423] Support enabled or disabled MCP server in console.
[#13543] Add MCP server import functionality with registry support.
[#13783] Add config metadata update admin api.
[#13808] Add Support official mcp registry protocol.
[#13814] Support prompt encrypt for mcp tools.

Enhancement/Refactor

[#13777] Enhance namespace exist check logic to improve code quality.
[#13829] Enhance the hint when publish duplicate name of agent.

BugFix

[#13744] Fix omitted CONFIG_INFO_GRAY_WRAPPER_ROW_MAPPER for config datasource plugin.
[#13752] Fix NPE and ignore InterruptedException stack log.
[#13761] Fix add validation when deleting roles to prevent issues like mistakenly deleting ROLE_ADMIN.
[#13767] Fix service NullPointerException when K8S getSpec().
[#13773] Fix preserve protocol slashes when building MCP OpenAPI-derived URLs.
[#13779] Fix Mcp tool description edit limitation.
[#13787] Fix bug where the Nacos Mcp console cannot correctly parse OpenApi files.
[#13801] Fix bug that sometimes garbled characters appear when parsing OpenAPI file URL in MCP console.
[#13810] Fix bug that caused inconsistent performance between Derby and MySQL databases when publishing configurations.
[#13824][#13826] Fix AI gRPC resource parser and leak auth login for MCP/A2A request in nacos-client.
[#13830] Fix agentCard subscribe judgement problem.
[#13832] Fix blur search may contain unexpected results.

Dependencies

[#13385] Upgrade os-maven-plugin version to 1.7.1.
[#13711] Upgrade spring boot version to 3.4.9.
[#13753] Upgrade grpc version to 1.75.0.
[#13825] Upgrade jraft version to 1.3.15.bugfix.

Deployment Required

New Contributors

• @Melod-YI made their first contribution in #13754
• @Similarityoung made their first contribution in #13774
• @iggzq made their first contribution in #13782
• @WangzJi made their first contribution in #13667
• @nihongye made their first contribution in #13827

Full Changelog: 3.0.3...3.1.0

This version is A beta version for 3.1.0.

In 3.1.0, Nacos follow the new MCP official registry protocol. All users can use Nacos as the MCP official registry private deployment to build their own private market or registry for MCP servers.
Nacos also support to import MCP server by MCP server spec json and support auto get tools by mcp url, These two new feature will improve usage for users to create MCP server into Nacos.
And also, this version support user enabled/disabled MCP server in console and support encrypt mcp tools schemes for storage with configuration encrypt plugin.

What's more, in this version Nacos support A2A registry which can allow users or agent framework like Spring AI Alibaba to publish and discovery AgentCard and agent endpoint. Current only support discovery by name of agent. Nacos will support discovery by skills, tags or descriptions in future.

Other Changes are to fix many bugs found before versions and do some dependencies upgrading.

Detail Changes in 3.1.0 see:

Feature

[#12191] Add namespace existence check.
[#13322] Support A2A registry.
[#13423] Support enabled or disabled MCP server in console.
[#13543] Add MCP server import functionality with registry support.
[#13783] Add config metadata update admin api.
[#13808] Add Support official mcp registry protocol.
[#13814] Support prompt encrypt for mcp tools.

Enhancement/Refactor

[#13777] Enhance namespace exist check logic to improve code quality.

BugFix

[#13744] Fix omitted CONFIG_INFO_GRAY_WRAPPER_ROW_MAPPER for config datasource plugin.
[#13752] Fix NPE and ignore InterruptedException stack log.
[#13761] Fix add validation when deleting roles to prevent issues like mistakenly deleting ROLE_ADMIN.
[#13767] Fix service NullPointerException when K8S getSpec().
[#13773] Fix preserve protocol slashes when building MCP OpenAPI-derived URLs.
[#13779] Fix Mcp tool description edit limitation.
[#13787] Fix bug where the Nacos Mcp console cannot correctly parse OpenApi files.
[#13801] Fix bug that sometimes garbled characters appear when parsing OpenAPI file URL in MCP console.
[#13810] Fix bug that caused inconsistent performance between Derby and MySQL databases when publishing configurations.

Dependencies

[#13385] Upgrade os-maven-plugin version to 1.7.1.
[#13711] Upgrade spring boot version to 3.4.9.
[#13753] Upgrade grpc version to 1.75.0.

Deployment Required

New Contributors

• @Melod-YI made their first contribution in #13754
• @Similarityoung made their first contribution in #13774
• @iggzq made their first contribution in #13782
• @WangzJi made their first contribution in #13667

Full Changelog: 3.0.3...3.1.0-BETA

This version is mainly focuses on MCP ecosystem expansion and performance optimization while balancing developer experience and system robustness. And fix many bugs for the old version.

About the new MCP registry features, Nacos added dynamic management of MCP tools (auto-fetch during creation/update), supported importing HTTP transfer tools via Swagger API files, and enhanced security schema definitions and client-side AI interaction APIs. And introduced memory index to optimize MCP ID/name query performance, supports custom gRPC listening IP configuration, and added frontEndpointConfig for streamlined frontend integration.

For the System & Experience Improvements, Nacos refactored MCP management UI, optimized Docker port configuration hints, improved service creation workflows, and strengthened validations (e.g., username/password checks, pre-deletion table existence verification). And also enhanced MCP server query logic and error logs, standardized readiness API responses, and ensured SDK consistency in returning MCP IDs.

Detail Changes in 3.0.3 see:

Feature

[#13441] Support add mcp tools when create mcp server.
[#13442] Support auto get mcp tools when create mcp server or update mcp server.
[#13455] Support Security Schema definition for mcp server.
[#13524][#13683] Add client api for AI mcp.
[#13526] Support memory index for mcpId and mcpName to improve performence.
[#13527] ADD frontEndpointConfig into McpInfo.
[#13542] Support import mcp tools by swagger API file for http transfer to mcp server.
[#13549] Support specified grpc listen ip replace the 0.0.0.0.

Enhancement/Refactor

[#13324] Add web hint when users use old way to access nacos console ui.
[#13437] Enhance the readiness API response code for v3 admin API.
[#13553] Ai maintainer sdk will return the mcpId when create new MCP Server.
[#13559] Enhance docker-desktop page export nacos ports configuration.
[#13565] Optimize error logs for MCP server not found scenario.
[#13585] Check if the table config_info_beta exists before deleting a BETA configuration.
[#13602] Enhance get the mcpserver logic to reduce the possible query mcp server after creating.
[#13625] Create user check username and password not blank.
[#13668][#13702] Enhance and refactor console UI for MCP management.
[#13678] Create new service when create new version mcp server.

BugFix

[#13367] Fix NPE problem for nacos-custom-environment-plugin.
[#13454] Fix logback 1.5+ will print hint and error when using spring cloud alibaba.
[#13458] Fix nacos start up failure when set functionMode is config or naming.
[#13468] Fix nacos config client can't fuzzy watch configuration by groupName.
[#13497] Fix service NullPointerException when getSpec().
[#13522] Ldap related beans are loaded into Spring properly.
[#13523] Fix DefaultPushFuture do not cancel when ConnectionBusyExeception throwed.
[#13566] Fix the paging query exception of the mcp list.
[#13585] Fix can't delete beta configuration problem.
[#13600] Fix CloneConfig got 403 code when user has not source namespace writen authentication.
[#13614] Fix namespace is not converted correctly, unable to query the configuration through the HTTP configuration query API.
[#13628] Fix NPE problem when update instance metadata with null value.
[#13648] Fix Configuration Management Fuzzy Search not work for groupName.

Deployment Required

New Contributors

• @backstraw made their first contribution in #13575
• @yuzhiping made their first contribution in #13568
• @lakeoffaith made their first contribution in #13412
• @lingyufei made their first contribution in #13583
• @weyuhui110 made their first contribution in #13584
• @misselvexu made their first contribution in #13604
• @FangYuan33 made their first contribution in #13611
• @howa118 made their first contribution in #13656
• @GoofySatoshi made their first contribution in #13674

Full Changelog: 3.0.2...3.0.3

This version is mainly fix some bugs found in 3.0.1 and 3.0.0. And also do some simple refactor to make code reasonable and readable.

Detail Changes in 3.0.2 see:

Enhancement/Refactor

[#13440] Enhance the mcp version hint for creating mcp server.
[#13492] Refactor Nacos MCP index of mcpId and mcpName.
[#13493] Refactor AbstractMapper under plugin/datasource to make code readable and enhance performance.
[#13494] Enhance the client logs to desensitise accessKey.

BugFix

[#13400] Fix naming subscriber get appName is - problem.
[#13432] Fix config controller response code bug when publish config is limited
[#13438] Fix use mcp name as endpoint name instead of mcp server id.
[#13445] Fix Nacos maintainer SDK not support aliyun ram auth plugin.
[#13449] Fix service list console ui wrong paged logic problem.
[#13460] Fix mcp managerment can't used when console ui deployment with independent.
[#13474] Fix stop config beta failure problem.
[#13501] Fix namespace migration task identify nacos server request no correct problem.
[#13514] Fix namespace errors may occur under scenarios with frequent configuration changes during Nacos 3.0 upgrade process.

Deployment Required

New Contributors

• @wuxuer made their first contribution in #13484
• @PengningYang made their first contribution in #13487
• @OmCheeLin made their first contribution in #13459
• @rst-coding made their first contribution in #13537

Full Changelog: 3.0.1.1...3.0.2

This version is fixed the block issue #13430. Other version changes please see 3.0.1

The following change logs is from 3.0.1:

This version is based on the 3.0.0 release and introduces support for MCP's multi-namespace management capabilities and multi-version management capabilities. The Nacos community has contributed to the MCP Registry API standard and is the first to implement the standard MCP Registry API.

When deploying Nacos 3.0.1, the standard MCP Registry API can be enabled by setting the parameter nacos.ai.mcp.registry.enabled=true, and the parameter nacos.ai.mcp.registry.port (default 9080) specifies the port for the MCP Registry API. Since the MCP Registry API requires additional ports and resources, it remains disabled by default in standard configurations.

Due to changes in the official MCP Registry API standard, metadata definitions for MCP Server have been updated, leading to potential incompatible data structure changes. Upgrading from version 3.0.0 to 3.0.1 may cause the console to fail reading data from previous MCP Servers. The Nacos community has provided a migration tool that relocates existing MCP Servers to the default namespace public after execution. Detailed instructions for using the migration tool mcp-migration-tool.jar are available in documentation.
With the MCP Registry API now finalized, the data structure of MCP Server has stabilized, ensuring backward compatibility in future releases.

In addition to new features, this version optimizes initial password prompts and startup scripts for Windows systems, while also fixing several bugs present in the 3.0.0 version.

Detail Changes in 3.0.1 see:

Feature/Refactor

[#13356] Support multiple namespace for MCP feature.
[#13377] Support mcp registry api in nacos mcp module.
[#13401] Support version controller for mcp server.

Enhancement/Refactor

[#13335] Enhance the windows startup.cmd to reduce duplicate hint for secret.token.key.
[#13348] Enhance the hints for initing password.

BugFix

[#13249] Fix configuration change plugin return incompatibility.
[#13267] Fix cannot delete service which contains illegal character.
[#13273] Fix create cluseter client don't use nacos.remote.client.grpc config.
[#13321] Fix prometheus metrics api can't accept problem.
[#13345] Fix apiClient readTimeout must be zero.
[#13368] Fix cannot delete the namespace in console ui problem.
[#13405] Fix listen config problem with default namespace.
[#13413] Fix Hints problem for mcp stdio server.

Deployment Required

New Contributors

• @zhilu-tang made their first contribution in #13298
• @Aias00 made their first contribution in #13364
• @2200376luhuabin made their first contribution in #13362
• @sunheyi6 made their first contribution in #13360
• @jujiale made their first contribution in #13380
• @Saltysth made their first contribution in #13397

Full Changelog: 3.0.0...3.0.1

Release Assets has updated to 3.0.1.1, Download from this release assets is same with 3.0.1.1 release.

This version is based on the 3.0.0 release and introduces support for MCP's multi-namespace management capabilities and multi-version management capabilities. The Nacos community has contributed to the MCP Registry API standard and is the first to implement the standard MCP Registry API.

When deploying Nacos 3.0.1, the standard MCP Registry API can be enabled by setting the parameter nacos.ai.mcp.registry.enabled=true, and the parameter nacos.ai.mcp.registry.port (default 9080) specifies the port for the MCP Registry API. Since the MCP Registry API requires additional ports and resources, it remains disabled by default in standard configurations.

Due to changes in the official MCP Registry API standard, metadata definitions for MCP Server have been updated, leading to potential incompatible data structure changes. Upgrading from version 3.0.0 to 3.0.1 may cause the console to fail reading data from previous MCP Servers. The Nacos community has provided a migration tool that relocates existing MCP Servers to the default namespace public after execution. Detailed instructions for using the migration tool mcp-migration-tool.jar are available in documentation.
With the MCP Registry API now finalized, the data structure of MCP Server has stabilized, ensuring backward compatibility in future releases.

In addition to new features, this version optimizes initial password prompts and startup scripts for Windows systems, while also fixing several bugs present in the 3.0.0 version.

Detail Changes in 3.0.1 see:

Feature/Refactor

[#13356] Support multiple namespace for MCP feature.
[#13377] Support mcp registry api in nacos mcp module.
[#13401] Support version controller for mcp server.

Enhancement/Refactor

[#13335] Enhance the windows startup.cmd to reduce duplicate hint for secret.token.key.
[#13348] Enhance the hints for initing password.

BugFix

[#13249] Fix configuration change plugin return incompatibility.
[#13267] Fix cannot delete service which contains illegal character.
[#13273] Fix create cluseter client don't use nacos.remote.client.grpc config.
[#13321] Fix prometheus metrics api can't accept problem.
[#13345] Fix apiClient readTimeout must be zero.
[#13368] Fix cannot delete the namespace in console ui problem.
[#13405] Fix listen config problem with default namespace.
[#13413] Fix Hints problem for mcp stdio server.

Deployment Required

New Contributors

• @zhilu-tang made their first contribution in #13298
• @Aias00 made their first contribution in #13364
• @2200376luhuabin made their first contribution in #13362
• @sunheyi6 made their first contribution in #13360
• @jujiale made their first contribution in #13380
• @Saltysth made their first contribution in #13397

Full Changelog: 3.0.0...3.0.1

3.0.0 (Apr 25th, 2025)

This version is a GA version of 3.0.0. In this version, Nacos based on Nacos 3.0.0-BETA to support MCP(Model Content Protocol) management.

In This 3.0.0 GA Version, Nacos will do these important features and changes:

1. APIs are categorized into different types, and different types of APIs will adopt different default authentication strategies.
2. Enabled nacos console authentication and need more configuration setting when deploying first time.
3. Nacos console UI use new v3 console API replace old v1 API, and default disable old v1 API old console UI used.
4. The default namespace public change its id from ``(empty string) to public.
5. Support xDS protocol directly. currently, support EDS, LDS, RDS and CDS.
6. Upgrade spring boot to 3.4.1 and upgrade jdk version to 17.
7. Add a serial of ADMIN API for Nacos 3.0 to make maintainer and custom console can maintain and get Nacos' data.
8. Support Nacos console independent deployment, some of configuration of nacos server and nacos console changed, please check applciation.properties beforce do upgrading.
9. Support MCP(Model Content Protocol) management.
10. Support experimental feature distributed lock.
11. Support experimental feature fuzzy listen services and configurations.

Detail Changes in 3.0.0 see:

Feature/Refactor

Sync services and endpoints from k8s.

• [#8309]

Support CDE, EDS, incremental EDS of xDS.

• [#8313]

Support LDS and RDS of xDS.

• [#10389]

Support fuzzy listen services and configuration

• [#11856][#12997][#13043][#13043]

Categorize Console APIs.

• [#12017][#12420][#12474][#12553][#12591]

Bump Spring Boot to 3.4.1

• [#12028][#13029]

Console UI use new Console APIs to replaced old APIs.

• [#12687][#12795][#12802][#12804]

Enabled Console APIs authentication by default.

• [#12813][#12814][#12816][#13001][#13007]

Deprecated old api and default disabled old api.

• [#12830]

Enabled Inner APIs authentication by default.

• [#12886]

Unified default namespace Id as public.

• [#12887]

Dependent Console port and Server port.

• [#12959][#12990][#13009][#13011]

Support distributed lock.

• [#12962]

Categorize new Admin APIs.

• [#12953][#12968][#12983][#12984][#12988][#13044][#13049]

New Nacos maintainer sdk.

• [#12979][#13064][#13081][#13086][#13087][#13089][#13095][#13100][#13101][#13118][#13112][#13154]

Support nacos console deployment independent.

• [#13072][#13080][#13110][#13134][#13142][#13146][#13149]

Nacos default auth plugin change to new login API

• [#13143][#13148][#13159]

Client will judge whether server support target feature like distributed lock or fuzzy watch.

• [#13155]

Enhance start up script to check required configuration and can setting them.

• [#13165]

Support for unifying empty namespaces and Public namespaces in the Nacos 3.0 configuration center.

• [#9846][#13187][#13188][#13192][#13194]

Support MCP(Model Content Protocol) management.

• [#13246]

BugFix

[#12972] Fix publish configuration with wrong namespace problem in console.
[#13038] Fix multiple thread initialize Spring Beans cause start up failed.
[#13057] Fix client can't callback listener for beta config.
[#13067] Fix prometheus auth manager problem.
[#13140] Fix Config change notify namespace support.
[#13156] Fix publish configuration with wrong namespace problem in console.
[#13160] Fix missing default namespace check when cloning/importing configuration.
[#13177] Fix missing subscriber for MembersChangeEvent.
[#13259] Fix default plugin check default namespace permission error.

New Contributors

• @EmanuelGi made their first contribution in #9220
• @RocketEngine26 made their first contribution in #9158
• @PoisonGravity made their first contribution in #11208
• @RickonZhang0929 made their first contribution in #12420
• @psxjoy made their first contribution in #13204
• @linwumingshi made their first contribution in #13222
• @chunhai1127 made their first contribution in #13235
• @luoxiner made their first contribution in #13301

Full Changelog: 2.5.1...3.0.0

The Beta 2 release is fix the block issue [#13200] in 3.0.0-BETA. So this release only for server part, without client part.

For issue [#13200], It cause 3.0.0-beta can't run with derby database which effect default starting up failed for standalone mode.

BugFix

• [#13200] Beta can't run with derby database.