alibaba/nacos
 Watch   
 Star   
 Fork   
简介统计版本
3 days ago
nacos
alibaba

3.2.1-2026.03.30

Nacos 3.2.1-2026.03.30 is a snapshot release focused on critical bug fixes for issues discovered in 3.2.0, particularly around AI module dependency conflicts, console UI bugs, and race conditions in the skill publish pipeline.

Key highlights include:

  • Dependency Resolution: Upgraded MCP SDK to 0.17.0 to resolve json-schema-validator conflicts affecting AI module functionality
  • AI Module Stability: Fixed race condition in skill publish pipeline and streamlined skill download routing
  • Console UI Fixes: Addressed configuration file editing errors and namespace ID validation issues in the new UI
  • Input Validation: Enhanced parameter validation in ops controller forms for better security

Feature

  • [#14794] Support force-publish skills for admin user

Enhancement/Refactor

  • [#14784] Validate input parameters in ops controller forms for better security

BugFix

  • [#14765] Fix configuration file editing error in 3.2 console
  • [#14768] Fix /v3/console/ai/mcp/importToolsFromMcp failure due to json-schema-validator dependency conflict
  • [#14771] Fix batch import failure in legacy console UI
  • [#14775] Add missing OIDC-related configurations to application.properties template
  • [#14783] Remove downloadSkillZip from AiClientProxy interface and route skill download directly to HTTP client
  • [#14786] Eliminate race condition in AI publish pipeline by pre-generating executionId
  • [#14794] Fix namespace ID validation issue in new UI when adding custom namespace

Dependencies

  • [#14782] Upgrade MCP SDK to 0.17.0 to resolve json-schema-validator conflict

Full Changelog: https://github.com/alibaba/nacos/compare/3.2.0...3.2.1-2026.03.30

6 days ago
nacos
alibaba

3.2.0 (Mar 27th, 2026)

Nacos 3.2.0 is a major release focused on plugin architecture enhancement, AI Registry expansion, API modernization, and code quality improvements. Key highlights include:

  • AI Registry Completes the "AI Triad": Skill Registry and Prompt Registry join existing MCP/Agent Registry, with Nacos Copilot integration for AI-assisted management
  • Plugin Architecture Modernization: Comprehensive SPI-based plugin management with console UI, cluster-wide synchronization, and PostgreSQL enhancements
  • API Cleanup: Legacy UDP PUSH support removed, /v1 and /v2 HTTP APIs extracted to submodules for future removal
  • Security & Code Quality: OIDC/OAuth2 authentication plugin, multiple FindBugs fixes, dead code removal, and JDK 17+ compatibility enhancements
  • Console Modernization: Dual UI support for new/legacy console switching with improved user experience

Feature

  • [#13699] Support outputSchema for MCP tools
  • [#14041] Merge nacos-plugin PostgreSQL & Base Implementation into main repository
  • [#14056] Refactor datasource plugins structure and enhance PostgreSQL capabilities
  • [#14077] Implement SPI-based plugin discovery and management API
  • [#14078] Implement cluster-wide state synchronization for plugins
  • [#14079] Add plugin management console UI and API
  • [#14084] Support MCP Tool _meta and annotations fields
  • [#14085] Enhance MCP tool metadata with annotations support
  • [#14101] Implement cluster-wide state synchronization
  • [#14109] Introduce Prompt Registry as core component of Nacos AI Registry
  • [#14110] Introduce Skills Registry to complement Nacos AI Registry vision
  • [#14117] Add plugin management console UI and API
  • [#14120] Add version parameter support to Maintainer SDK Get Agent Card method
  • [#14527] Add OIDC/OAuth2 Authentication Plugin (Server)
  • [#14534] Add find-skill-from-nacos capability for intelligent skill discovery
  • [#14623] Add skill-scanner integration for AI Skill security scanning
  • [#14641] Update Nacos console UI with modern design
  • [#14653] Support dual UI switching between new and legacy console with contextPath adaptation
  • [#14672] Skill support for data level access and visibility Phase 2
  • [#14677] Skill support for data level access and visibility Phase 3

Enhancement/Refactor

  • [#14048] Refactor datasource plugins structure and enhance PostgreSQL capabilities
  • [#14050] Extract /v1 and /v2 HTTP APIs to submodules for future removal
  • [#14052] Remove UDP PUSH support for naming module
  • [#14057] Refactor CreateTool and support output scheme
  • [#14074] Remove legacy UDP PUSH support from naming module
  • [#14122] Add JVM --add-opens options for JDK 17+ compatibility in startup scripts
  • [#14125] Activate dev profile by default for plugin dependencies
  • [#14441] Refactor version comparison and JSON field handling with constants
  • [#14461] Remove obsolete p3c-pmd plugin and cleanup annotations
  • [#14463] Unify component scanning with custom package exclusion
  • [#14468] Unify component scanning with custom package exclusion
  • [#14546] Remove unused common.cache package (dead code from Guava removal attempt)
  • [#14585] Refactor admin API input from JSON body to form params
  • [#14640] Refactor database plugins and update CI report paths

BugFix

  • [#13770] Fix missing context path in importToolsFromMcp and other AI-related APIs
  • [#14009] Fix UUID passing issue in configuration fuzzy listening causing initialization events to be filtered
  • [#14016] Fix Console automatic server member synchronization in distributed deployment
  • [#14020] Fix missing '?' placeholder in database query
  • [#14024] Fix MCP cache index inconsistency when recreating MCP server with same name
  • [#14028] Fix remote server selection to use healthy nodes during import/export operations
  • [#14063] Fix control plugin bug
  • [#14104] Fix AI API context path errors in console
  • [#14114] Fix incorrect grayRule detection in ConfigMigrateService
  • [#14121] Fix console-ui pagination reset to 0 instead of 1 on API error
  • [#14210] Fix MainLayout to handle language changes and fetch notices on update
  • [#14307] Add JVM --add-opens options for JDK 17+ compatibility in startup scripts
  • [#14401] Fix incorrect created field returned by ConfigRowMapperInjector
  • [#14402] Fix MySQL LIKE query escaping to prevent underscore and hyphen confusion
  • [#14442] Fix Derby and MySQL LIKE query with proper escape handling
  • [#14450] Fix console remote server context-path for maintainer-client
  • [#14454] Throw proper exception when form parameters exceed size limit
  • [#14471] Replace Long.valueOf() with Long.parseLong() to avoid unnecessary boxing
  • [#14479] Fix typo, incorrect Javadoc and improve resource management in health check processors
  • [#14484] Add 'type' and 'md5' fields to findConfigInfoLike4PageFetchRows for plugin development
  • [#14486] Remove unnecessary equals() override in enum classes
  • [#14491] Fix DumpChangeGrayConfigWorker NPE
  • [#14509] Fix non-short-circuit operator in for-loop condition
  • [#14510] Fix clone() not calling super.clone() in ConfigForm
  • [#14515] Fix unnecessary equals() override in enum classes
  • [#14527] Add OIDC/OAuth2 Authentication Plugin (Server)
  • [#14533] Fix DM_DEFAULT_ENCODING: add explicit charset to avoid platform-dependent encoding
  • [#14538] Fix DMI_RANDOM_USED_ONLY_ONCE: replace new Random() with ThreadLocalRandom
  • [#14545] Remove unused common.cache package
  • [#14547] Fix HE_EQUALS_USE_HASHCODE: add missing hashCode() to Config model classes
  • [#14548] Fix NP_PARAMETER_MUST_BE_NONNULL_BUT_MARKED_AS_NULLABLE: add null check in GrpcConnection callback
  • [#14567] Fix console-ui TypeError in MainLayout and improve copilot module loading
  • [#14616] Fix naming module pagination parameter validation
  • [#14622] Exclude json-schema-validator 3.0.0 from agentscope-core to resolve NoClassDefFoundError
  • [#14625] Fix NoClassDefFoundError by excluding conflicting json-schema-validator dependency
  • [#14635] Fix health status update method to correctly handle persistent instances
  • [#14712] Fix Skill ZIP upload losing SKILL.md content

Dependencies

  • [#11180] Upgrade jraft-core version to 1.4.0
  • [#14006] Upgrade Spring Boot to 3.4.10 to address CVE-2025-55752
  • [#14055] Bump org.apache.logging.log4j:log4j-core from 2.24.3 to 2.25.3
  • [#14625] Exclude json-schema-validator 3.0.0 from agentscope-core
  • [#14714] Upgrade gRPC version to 1.78.0

⚠️ Breaking Changes & Migration Notes

Database Schema Changes (Important)

Action Required: This release introduces significant database schema changes with multiple new tables added for plugin management, AI Registry (Skill/Prompt), and enhanced audit capabilities.

Before upgrading, you must apply the new schema:

  1. Backup your existing database
  2. Apply the schema upgrade script: conf/schema.sql (for MySQL) or corresponding script for your database type
  3. Restart Nacos server after schema migration

Failure to apply the schema changes may result in plugin management, AI Registry, and other new features not functioning correctly.

API Legacy Adapter Plugin (Important)

Action Required: The plugins directory includes the api-legacy-adapter plugin by default to maintain compatibility with extracted /v1 and /v2 HTTP APIs. This plugin will be removed in future versions.

If you have confirmed that your deployment no longer uses the legacy /v1 or /v2 APIs, you can safely remove the api-legacy-adapter plugin from the plugins directory immediately to reduce footprint.

Naming Module: UDP PUSH Support Removed

The naming module has removed legacy UDP PUSH support, moving to a cleaner HTTP API architecture. Clients relying on UDP-based service discovery updates must migrate to HTTP-based mechanisms.

Java Version Requirements

Module Java Required
Nacos-Server / Nacos-Console Java 17
Nacos-Client Java 8
Nacos-Maintainer-Client Java 8

📚 What's New in AI Registry

Skill Registry

  • Centralized Management: Create, update, and version skills via UI or API with changelogs
  • Skill Composition: Chain multiple MCP tools into business-meaningful capabilities (e.g., "user_onboarding" = verify_email + create_profile + send_welcome_email)
  • MCP Integration: Skills explicitly declare dependencies on registered MCP tools with integrity validation
  • Folder-based Organization: Skills displayed in multi-level folder structure for better organization
  • Agent-Friendly APIs: REST/gRPC APIs for agent frameworks (LangChain, CrewAI, etc.) to discover and subscribe to skills
  • Upload Support: Upload skill packages (zip format, max 10MB) with authentication
  • Security Scanning: Integrated skill-scanner for AI Skill security validation
  • Data Level Access: Fine-grained visibility and access control (Phase 2 & 3)

Prompt Registry

  • First-Class Configuration: Store prompts with metadata (agentId, modelId, version, tags) as versioned config artifacts
  • Multi-Version Management: Support parallel multi-version management with template and commit message tracking
  • Tag-Based Subscription: Subscribe to prompts by tags for dynamic updates
  • Interactive Debugging: Test and compare prompt outputs across versions directly in console
  • AI Client Proxy: Unified HTTP/gRPC client interface for prompt operations

Nacos Copilot

  • AI-Powered Assistant: Integrated AI assistant to help optimize and create Prompts and Skills
  • Intelligent Discovery: Automatically find relevant existing skills from the registry
  • Console Integration: Accessible directly from Nacos console for seamless workflow

New Contributors

Full Changelog: https://github.com/alibaba/nacos/compare/3.1.1...3.2.0

8 days ago
nacos
alibaba

3.1.2

Nacos 3.1.2 is a patch release focused on stability improvements, security fixes, and AI module enhancements. Key highlights include:

  • Security: Upgraded Spring Boot to 3.4.10 to address CVE-2025-55752, plus log4j and gRPC dependency updates
  • AI/MCP: Fixed MCP cache inconsistency issues and added version parameter support for Agent Card queries
  • Console: Improved distributed deployment experience with automatic server member sync and fixed multiple context path issues
  • Client: Eliminated class unloading memory leak during config reload and fixed UUID passing issue in fuzzy listening
  • Config: Enhanced config metadata publishing with audit logging and notifications

Feature

  • [#13996] Add event publishing for agent and MCP endpoint operations
  • [#13999] Add audit logging and notifications for config metadata publishing
  • [#14120] Add version parameter support to Maintainer SDK Get Agent Card method

Enhancement/Refactor

  • [#14000] Eliminate class unloading memory leak during configuration reload using Configuration.initialize()
  • [#14062] Prevent potential data modification risk in client ServiceInfoHolder
  • [#14099] Add validation for serviceName and groupName in SubscribeServiceRequestHandler
  • [#14449] Remove ineffective ThreadLocal in MD5Utils
  • [#14454] Throw proper exception when form parameters exceed size limit

BugFix

  • [#13770] Fix missing context path in importToolsFromMcp and other AI-related APIs
  • [#14009] Fix UUID passing issue in configuration fuzzy listening causing initialization events to be filtered
  • [#14016] Fix Console automatic server member synchronization in distributed deployment
  • [#14020] Fix missing '?' placeholder in database query
  • [#14024] Fix MCP cache index inconsistency when recreating MCP server with same name
  • [#14028] Fix remote server selection to use healthy nodes during import/export operations
  • [#14063] Fix control plugin bug
  • [#14104] Fix AI API context path errors in console
  • [#14114] Fix incorrect grayRule detection in ConfigMigrateService
  • [#14121] Fix console-ui pagination reset to 0 instead of 1 on API error
  • [#14210] Fix MainLayout to handle language changes and fetch notices on update
  • [#14401] Fix incorrect created field returned by ConfigRowMapperInjector
  • [#14402] Fix MySQL LIKE query escaping to prevent underscore and hyphen confusion
  • [#14442] Fix Derby and MySQL LIKE query with proper escape handling
  • [#14450] Fix console remote server context-path for maintainer-client
  • [#14635] Fix health status update method to correctly handle persistent instances

Dependencies

  • [#14006] Upgrade Spring Boot to 3.4.10 to address CVE-2025-55752
  • [#14055] Bump org.apache.logging.log4j:log4j-core from 2.24.3 to 2.25.3
  • [#14714] Upgrade gRPC version to 1.78.0

Deployment Required

Module Java Required
Nacos-Server/Nacos-Console Java 17
Nacos-Client Java 8
Nacos-Maintainer-Client Java 8

Contributors

Thanks to all contributors: @KomachiSion, @chunhai1127, @INotWant, @chlch, and the Nacos community.

Full Changelog: https://github.com/alibaba/nacos/compare/3.1.1...3.1.2

24 days ago
nacos
alibaba

3.2.0-BETA (Mar 9th, 2026)

Nacos 3.2.0 Release Notes

This version focuses on plugin architecture enhancement, API modernization, AI Registry expansion, and code quality improvements.

🎯 Major Highlights

AI Registry Completes the "AI Triad"

Nacos 3.2.0 introduces Skill Registry and Prompt Registry, completing the AI control plane vision alongside existing MCP Registry and Agent Registry:

  • Skill Registry: Centralized management for reusable, business-aligned capabilities composed of MCP tools with versioning, tags, and folder-based organization
  • Prompt Registry: First-class prompt management with multi-version support, tag-based subscription, template management, and A/B testing capabilities
  • Nacos Copilot: AI-powered assistant integrated into Nacos console, helping users optimize/create Prompts and Skills, and intelligently find existing skills from the registry

Plugin Architecture Modernization

Comprehensive plugin management system with SPI-based plugin discovery, management console UI, and cluster-wide state synchronization. PostgreSQL datasource plugin receives significant enhancements with merged implementations from nacos-plugin repository.

API Cleanup

The naming module removes legacy UDP PUSH support, moving to a cleaner HTTP API architecture with /v1 and /v2 APIs extracted to submodules for future removal.

MCP Enhancements

MCP (Model Context Protocol) support is expanded with tool _meta, annotations fields, and output scheme support.

Code Quality & Compatibility

Multiple FindBugs/SpotBugs fixes, dead code removal, and JDK 17+ compatibility enhancements.

⚠️ Breaking Changes & Migration Notes

API Legacy Adapter Plugin (Important)

Action Required: In this version, the plugins directory includes the api-legacy-adapter plugin by default to maintain compatibility with extracted /v1 and /v2 HTTP APIs. This plugin will be removed in future versions.

If you have confirmed that your deployment no longer uses the legacy /v1 or /v2 APIs, you can safely remove the api-legacy-adapter plugin from the plugins directory immediately to reduce footprint.

Feature

[#14050] Extract /v1 and /v2 HTTP APIs to submodules for future removal. [#14052] Remove UDP PUSH support for naming module. [#14077] Implement SPI-based plugin discovery and management API. [#14078] Implement cluster-wide state synchronization. [#14079] Add plugin management console UI and API. [#14084] Support MCP Tool _meta and annotations fields. [#14109] Introduce Prompt Registry as a core component of Nacos AI Registry. [#14110] Introduce Skills Registry to complement Nacos AI Registry vision. [#14122] Add JVM --add-opens options for JDK 17+ compatibility in startup scripts. [#14245] Integrate Nacos Copilot for AI-assisted Prompt and Skill management. [#14440] Add Prompt Registry with multi-version management support. [#14453] Support tag-based subscription and management for Prompts. [#14484] Add 'type' and 'md5' fields to findConfigInfoLike4PageFetchRows for plugin development. [#14505] Refactor Prompt Registry to support parallel multi-version management. [#14525] Add AI client proxy interface supporting HTTP and gRPC transport. [#14534] Add find-skill-from-nacos capability for intelligent skill discovery.

Enhancement/Refactor

[#13699] Support outputSchema for MCP tools. [#14048] Refactor datasource plugins structure and enhance PostgreSQL capabilities. [#14056] Support output scheme and refactor the CreateTool. [#14057] Refactor CreateTool and support output scheme. [#14441] Refactor version comparison and JSON field handling with constants. [#14461] Remove obsolete p3c-pmd plugin and cleanup annotations. [#14463] Unify component scanning with custom package exclusion. [#14468] Unify component scanning with custom package exclusion. [#14479] Fix typo, incorrect Javadoc and improve resource management in health check processors. [#14486] Remove unnecessary equals() override in enum classes. [#14489] Align PostgreSQL trusted function enum and enrich tag queries. [#14537] Normalize escaped YAML parsing and stabilize skill export/import roundtrips. [#14545] Remove unused common.cache package (dead code from Guava removal attempt). [#14565] Extract common RemoteServerConnector for AI services.

BugFix

[#14084] Support meta and annotation in mcp tools. [#14117] Add plugin management console UI and API. [#14471] Replace Long.valueOf() with Long.parseLong() to avoid unnecessary boxing. [#14484] Add 'type' and 'md5' fields to findConfigInfoLike4PageFetchRows for plugin development. [#14491] Fix DumpChangeGrayConfigWorker NPE. [#14509] Fix non-short-circuit operator in for-loop condition. [#14510] Fix clone() not calling super.clone() in ConfigForm. [#14527] Add OIDC/OAuth2 Authentication Plugin (Server). [#14533] Fix DM_DEFAULT_ENCODING: add explicit charset to avoid platform-dependent encoding. [#14538] Fix DMI_RANDOM_USED_ONLY_ONCE: replace new Random() with ThreadLocalRandom. [#14547] Fix HE_EQUALS_USE_HASHCODE: add missing hashCode() to Config model classes. [#14548] Fix NP_PARAMETER_MUST_BE_NONNULL_BUT_MARKED_AS_NULLABLE: add null check in GrpcConnection callback. [#14567] Fix console-ui TypeError in MainLayout and improve copilot module loading.

Dependencies

[#11180] Upgrade jraft-core version to 1.4.0.

Deployment Required

Module Java Required
Nacos-Server/Nacos-Console Java 17
Nacos-Client Java 8
Nacos-Maintainer-Client Java 8

📚 What's New in AI Registry

Skill Registry

  • Centralized Management: Create, update, and version skills via UI or API with changelogs
  • Skill Composition: Chain multiple MCP tools into business-meaningful capabilities (e.g., "user_onboarding" = verify_email + create_profile + send_welcome_email)
  • MCP Integration: Skills explicitly declare dependencies on registered MCP tools with integrity validation
  • Folder-based Organization: Skills displayed in multi-level folder structure for better organization
  • Agent-Friendly APIs: REST/gRPC APIs for agent frameworks (LangChain, CrewAI, etc.) to discover and subscribe to skills
  • Upload Support: Upload skill packages (zip format, max 10MB) with authentication

Prompt Registry

  • First-Class Configuration: Store prompts with metadata (agentId, modelId, version, tags) as versioned config artifacts
  • Multi-Version Management: Support parallel multi-version management with template and commit message tracking
  • Tag-Based Subscription: Subscribe to prompts by tags for dynamic updates
  • Interactive Debugging: Test and compare prompt outputs across versions directly in console
  • AI Client Proxy: Unified HTTP/gRPC client interface for prompt operations

Nacos Copilot

  • AI-Powered Assistant: Integrated AI assistant to help optimize and create Prompts and Skills
  • Intelligent Discovery: Automatically find relevant existing skills from the registry
  • Console Integration: Accessible directly from Nacos console for seamless workflow

New Contributors

Full Changelog: https://github.com/alibaba/nacos/compare/3.1.1...3.2.0-BETA

2025-11-26 15:07:22
nacos
alibaba

3.1.1 (Nov 26th 2025)

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

Module Java Required
Nacos-Server/Nacos-Console Java 17
Nacos-Client Java 8
Nacos-Maintainer-Client Java 8

New Contributors

Full Changelog: https://github.com/alibaba/nacos/compare/3.1.0-bugfix...3.1.1

2025-11-17 10:07:26
nacos
alibaba

2.5.2 (Nov 17th, 2025)

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

Full Changelog: https://github.com/alibaba/nacos/compare/2.5.1...2.5.2

2025-09-22 10:56:34
nacos
alibaba

3.1.0 (Sep 22th, 2025)

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

Module Java Required
Nacos-Server/Nacos-Console Java 17
Nacos-Client Java 8
Nacos-Maintainer-Client Java 8

New Contributors

Full Changelog: https://github.com/alibaba/nacos/compare/3.0.3...3.1.0

2025-09-16 16:18:50
nacos
alibaba

3.1.0-BETA (Sep 16th, 2025)

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

Module Java Required
Nacos-Server/Nacos-Console Java 17
Nacos-Client Java 8
Nacos-Maintainer-Client Java 8

New Contributors

Full Changelog: https://github.com/alibaba/nacos/compare/3.0.3...3.1.0-BETA

2025-08-21 10:47:23
nacos
alibaba

3.0.3(Aug 21th, 2025)

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

Module Java Required
Nacos-Server/Nacos-Console Java 17
Nacos-Client Java 8
Nacos-Maintainer-Client Java 8

New Contributors

Full Changelog: https://github.com/alibaba/nacos/compare/3.0.2...3.0.3

2025-06-25 14:27:33
nacos
alibaba

3.0.2(June 25th, 2025)

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

Module Java Required
Nacos-Server/Nacos-Console Java 17
Nacos-Client Java 8
Nacos-Maintainer-Client Java 8

New Contributors

Full Changelog: https://github.com/alibaba/nacos/compare/3.0.1.1...3.0.2