Nacos

https://nacos.io/docs/latest/
Admin
Nacos is a dynamic service discovery, configuration management, and AI agent management platform...
Tokens:761,459
Snippets:3,953
Trust Score:9.6
Update:5 days ago
Show doc for...
Tokens:
Raw
### Get All Instances Example

Source: https://nacos.io/docs/latest/guide/user/sdk

Example showing how to retrieve and print all instances for a service.

```java

NamingService naming = NamingFactory.createNamingService(System.getProperty("serveAddr"));
System.out.println(naming.getAllInstances("nacos.test.3"));

```

--------------------------------

### Skill Get Usage Examples

Source: https://nacos.io/docs/latest/manual/admin/nacos-cli

Examples for downloading skills to default or custom directories.

```bash
# 下载到默认目录 (~/.skills)
nacos-cli skill-get <skill-name>


# 下载到指定目录
nacos-cli skill-get <skill-name> -o /custom/path


# 交互模式
nacos> skill-get <skill-name>
```

--------------------------------

### Get Prompt Usage Example

Source: https://nacos.io/docs/latest/manual/user/java-sdk/usage

Example of initializing the AiService and retrieving a prompt by its key.

```java
Properties properties = new Properties();
properties.setProperty(PropertyKeyConst.SERVER_ADDR, "{serverAddr}");
AiService aiService = AiFactory.createAiService(properties);
try {
    Prompt prompt = aiService.getPrompt("{promptKey}");
    System.out.println(JacksonUtils.toJson(prompt));
} catch (NacosException e) {
    e.printStackTrace();
}
```

--------------------------------

### Get Configuration with Listener Example

Source: https://nacos.io/docs/latest/manual/user/java-sdk/usage

Example of retrieving a configuration and registering a listener using getConfigAndSignListener.

```java

try {
    String serverAddr = "{serverAddr}";
    String dataId = "{dataId}";
    String group = "{group}";
    Properties properties = new Properties();
    properties.put("serverAddr", serverAddr);
    ConfigService configService = NacosFactory.createConfigService(properties);
    String content = configService.getConfigAndSignListener(dataId, group, 5000, new Listener() {
        @Override
        public void receiveConfigInfo(String configInfo) {
            System.out.println("recieve1:" + configInfo);
        }
        @Override
        public Executor getExecutor() {
            return null;
        }
    });
    System.out.println(content);
} catch (NacosException e) {
    e.printStackTrace();
}

```

--------------------------------

### Get configuration example

Source: https://nacos.io/docs/latest/manual/user/java-sdk/usage

Example of retrieving a configuration value using ConfigService.

```java

try {
    String serverAddr = "{serverAddr}";
    String dataId = "{dataId}";
    String group = "{group}";
    Properties properties = new Properties();
    properties.put("serverAddr", serverAddr);
    ConfigService configService = NacosFactory.createConfigService(properties);
    String content = configService.getConfig(dataId, group, 5000);
    System.out.println(content);
} catch (NacosException e) {
    e.printStackTrace();
}

```

--------------------------------

### Get subscribed services example

Source: https://nacos.io/docs/latest/manual/user/java-sdk/usage

Example demonstrating how to retrieve and print the list of services the client is currently subscribed to.

```java
NamingService naming = NamingFactory.createNamingService(System.getProperty("serveAddr"));
System.out.println(naming.getSubscribeServices());
```

--------------------------------

### Get Prompt By Version Usage Example

Source: https://nacos.io/docs/latest/manual/user/java-sdk/usage

Example of retrieving a specific version of a prompt.

```java
Properties properties = new Properties();
properties.setProperty(PropertyKeyConst.SERVER_ADDR, "{serverAddr}");
AiService aiService = AiFactory.createAiService(properties);
try {
    Prompt prompt = aiService.getPromptByVersion("{promptKey}", "1.0.0");
    System.out.println(JacksonUtils.toJson(prompt));
} catch (NacosException e) {
    e.printStackTrace();
}
```

--------------------------------

### Get Server Status Usage Example

Source: https://nacos.io/docs/latest/manual/user/java-sdk/usage

Example showing how to create a NamingService and retrieve the server status.

```java

NamingService naming = NacosFactory.createNamingService("{serverAddr}");
String status = naming.getServerStatus();
System.out.println(status);

```

--------------------------------

### Configuration priority examples

Source: https://nacos.io/docs/latest/manual/admin/nacos-cli

Examples demonstrating how different configuration methods interact.

```bash
# 使用 dev profile，但通过命令行覆盖 host
nacos-cli --profile dev --host 10.0.0.1 skill-list


# 显式指定配置文件
nacos-cli --config /path/to/custom.conf skill-list


# 使用环境变量（命令行、--config、profile 均未提供时）
NACOS_HOST=127.0.0.1 NACOS_PORT=8848 NACOS_NAMESPACE=xxx nacos-cli skill-list


# 不传任何参数时，自动进入交互向导生成 default profile，并连接其中的服务器
nacos-cli


# 仅传 --host 时，端口默认 8848
nacos-cli --host 127.0.0.1


# 仅传 --port 时，host 默认 127.0.0.1
nacos-cli --port 8849
```

--------------------------------

### Fetch Configuration Example

Source: https://nacos.io/docs/latest/guide/user/sdk

Example of creating a ConfigService and fetching a configuration value.

```java
try {
  String serverAddr = "{serverAddr}";
  String dataId = "{dataId}";
  String group = "{group}";
  Properties properties = new Properties();
  properties.put("serverAddr", serverAddr);
  ConfigService configService = NacosFactory.createConfigService(properties);
  String content = configService.getConfig(dataId, group, 5000);
  System.out.println(content);
} catch (NacosException e) {
    // TODO Auto-generated catch block
    e.printStackTrace();
}
```

--------------------------------

### Register Instance Example

Source: https://nacos.io/docs/latest/guide/user/sdk

Example demonstrating how to register an instance with specific metadata, service configuration, and cluster health checks.

```java

NamingService naming = NamingFactory.createNamingService(System.getProperty("serveAddr"));
naming.registerInstance("nacos.test.3", "11.11.11.11", 8888, "TEST1");


Instance instance = new Instance();
instance.setIp("55.55.55.55");
instance.setPort(9999);
instance.setHealthy(false);
instance.setWeight(2.0);
Map<String, String> instanceMeta = new HashMap<>();
instanceMeta.put("site", "et2");
instance.setMetadata(instanceMeta);


Service service = new Service("nacos.test.4");
service.setApp("nacos-naming");
service.sethealthCheckMode("server");
service.setEnableHealthCheck(true);
service.setProtectThreshold(0.8F);
service.setGroup("CNCF");
Map<String, String> serviceMeta = new HashMap<>();
serviceMeta.put("symmetricCall", "true");
service.setMetadata(serviceMeta);
instance.setService(service);


Cluster cluster = new Cluster();
cluster.setName("TEST5");
AbstractHealthChecker.Http healthChecker = new AbstractHealthChecker.Http();
healthChecker.setExpectedResponseCode(400);
healthChecker.setCurlHost("USer-Agent|Nacos");
healthChecker.setCurlPath("/xxx.html");
cluster.setHealthChecker(healthChecker);
Map<String, String> clusterMeta = new HashMap<>();
clusterMeta.put("xxx", "yyyy");
cluster.setMetadata(clusterMeta);


instance.setCluster(cluster);


naming.registerInstance("nacos.test.4", instance);

```

--------------------------------

### Get Prompt By Label Usage Example

Source: https://nacos.io/docs/latest/manual/user/java-sdk/usage

Example of retrieving a prompt using a specific label.

```java
Properties properties = new Properties();
properties.setProperty(PropertyKeyConst.SERVER_ADDR, "{serverAddr}");
AiService aiService = AiFactory.createAiService(properties);
try {
    Prompt prompt = aiService.getPromptByLabel("{promptKey}", "{label}");
    System.out.println(JacksonUtils.toJson(prompt));
} catch (NacosException e) {
    e.printStackTrace();
}
```

--------------------------------

### Query MCP Service Example

Source: https://nacos.io/docs/latest/manual/user/java-sdk/usage

Demonstrates how to initialize the AiService and query MCP service details.

```java
Properties properties = new Properties();
properties.setProperty(PropertyKeyConst.SERVER_ADDR, "{serverAddr}");
AiService aiService = AiFactory.createAiService(properties);
try {
    McpServerDetailInfo detailInfo = aiService.getMcpServer(mcpName, null);
    System.out.println(JacksonUtils.toJson(detailInfo));
} catch (Exception e) {
    e.printStackTrace();
}
```

--------------------------------

### createMcpServer usage example

Source: https://nacos.io/docs/latest/manual/admin/maintainer-sdk

Demonstrates how to configure McpServerBasicInfo and invoke the createMcpServer method.

```java

try {
    McpServerBasicInfo serverSpec = new McpServerBasicInfo();
    serverSpec.setName("my-mcp");
    serverSpec.setProtocol(AiConstants.Mcp.MCP_PROTOCOL_STDIO);
    ServerVersionDetail versionDetail = new ServerVersionDetail();
    versionDetail.setVersion("1.0.0");
    serverSpec.setVersionDetail(versionDetail);
    String result = aiMaintainerService.createMcpServer("my-mcp", serverSpec, null, null);
    result = aiMaintainerService.createMcpServer(Constants.DEFAULT_NAMESPACE_ID, "my-mcp", serverSpec, null, null);
} catch (NacosException e) {
    e.printStackTrace();
}

```

--------------------------------

### Skill Upload Usage Examples

Source: https://nacos.io/docs/latest/manual/admin/nacos-cli

Examples for uploading single or multiple skills.

```bash
# 上传单个技能
nacos-cli skill-upload /path/to/skill


# 批量上传
nacos-cli skill-upload --all /path/to/skills/folder


# 交互模式
nacos> skill-upload /path/to/skill
nacos> skill-upload --all /path/to/skills
```

--------------------------------

### Get Skill Detail Usage Example

Source: https://nacos.io/docs/latest/manual/admin/maintainer-sdk

Example of retrieving Skill details using the aiMaintainerService.

```java
try {
    Skill skill = aiMaintainerService.getSkillDetail("public", "my-skill");
    skill = aiMaintainerService.getSkillDetail("my-skill");
} catch (NacosException e) {
    e.printStackTrace();
}
```

--------------------------------

### System Installation Directory Structure

Source: https://nacos.io/docs/latest/manual/admin/deployment/deployment-nacos-setup

The directory structure for the Nacos setup installation located at /usr/local/nacos-setup/.

```text
/usr/local/nacos-setup/
├── bin/
│   └── nacos-setup          # 主命令
└── lib/
    ├── cluster.sh           # 集群模式实现
    ├── standalone.sh        # 单机模式实现
    ├── common.sh            # 通用工具
    ├── port_manager.sh      # 端口管理
    ├── download.sh          # 下载管理
    ├── config_manager.sh    # 配置管理
    ├── java_manager.sh      # Java 环境管理
    └── process_manager.sh   # 进程管理
```

--------------------------------

### queryBeta usage example

Source: https://nacos.io/docs/latest/manual/admin/maintainer-sdk

Demonstrates publishing a Beta configuration and then querying its details using the queryBeta method.

```java

try {
    # 对`127.0.0.1`这个ip进行`maintain.client.test`配置的Beta灰度。
    boolean publishResult = configMaintainerService.publishBetaConfig("maintain.client.test", Constants.DEFAULT_GROUP, Constants.DEFAULT_NAMESPACE_ID, "testBeta", "testApp", "", "testTag1", "test", "TEXT", "127.0.0.1");
    # 查询`maintain.client.test`配置的Beta灰度
    ConfigGrayInfo result = configMaintainerService.queryBeta("maintain.client.test", Constants.DEFAULT_GROUP);
    result = configMaintainerService.queryBeta("maintain.client.test", Constants.DEFAULT_GROUP, Constants.DEFAULT_NAMESPACE_ID);}
catch (NacosException e) {
    e.printStackTrace();
}

```

--------------------------------

### Get Configuration via HTTP GET

Source: https://nacos.io/docs/latest/manual/user/open-api

Example of retrieving a specific configuration using the /nacos/v3/client/cs/config endpoint.

```bash
curl -X GET '127.0.0.1:8848/nacos/v3/client/cs/config?dataId=test&groupName=test'
```

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "resultCode": 200,
    "errorCode": 0,
    "message": null,
    "requestId": null,
    "content": "test",
    "encryptedDataKey": null,
    "contentType": "text",
    "md5": "098f6bcd4621d373cade4e832627b4f6",
    "lastModified": 1743151634823,
    "tag": null,
    "beta": false,
    "success": true
  }
}
```

--------------------------------

### Subscribe to MCP Service Example

Source: https://nacos.io/docs/latest/manual/user/java-sdk/usage

Example showing how to initialize the AiService and subscribe to an MCP service using a custom listener.

```java
Properties properties = new Properties();
properties.setProperty(PropertyKeyConst.SERVER_ADDR, "{serverAddr}");
AiService aiService = AiFactory.createAiService(properties);
try {
    ExampleListener listener = new ExampleListener(i);
    aiService.subscribeMcpServer(mcpName, listener);
} catch (Exception e) {
    e.printStackTrace();
}
```

--------------------------------

### Select Instances Example

Source: https://nacos.io/docs/latest/guide/user/sdk

Example showing how to retrieve only healthy instances for a service.

```java

NamingService naming = NamingFactory.createNamingService(System.getProperty("serveAddr"));
System.out.println(naming.selectInstances("nacos.test.3", true));

```

--------------------------------

### Get paginated service list example

Source: https://nacos.io/docs/latest/manual/user/java-sdk/usage

Example showing how to retrieve a paginated list of services and print the count and data.

```java
NamingService naming = NamingFactory.createNamingService(System.getProperty("serveAddr"));
// 等价于`naming.getServicesOfServer(1, 10, "DEFAULT_GROUP");`
ListView<String> result = naming.getServicesOfServer(1, 10);
System.out.println(result.getCount());
System.out.println(result.getData());
```

--------------------------------

### getAllInstances Usage Example

Source: https://nacos.io/docs/latest/manual/user/java-sdk/usage

Example demonstrating various ways to call getAllInstances to retrieve service instances.

```java
NamingService naming = NamingFactory.createNamingService(System.getProperty("serveAddr"));
// 以下查询请求所造成的结果均一致.
System.out.println(naming.getAllInstances("nacos.test.service"));
System.out.println(naming.getAllInstances("nacos.test.service", "DEFAULT_GROUP"));
System.out.println(naming.getAllInstances("nacos.test.service", true));
System.out.println(naming.getAllInstances("nacos.test.service", "DEFAULT_GROUP", true));
System.out.println(naming.getAllInstances("nacos.test.service", new ArrayList<>()));
System.out.println(naming.getAllInstances("nacos.test.service", "DEFAULT_GROUP", new ArrayList<>()));
System.out.println(naming.getAllInstances("nacos.test.service", new ArrayList<>(), true));
System.out.println(naming.getAllInstances("nacos.test.service", "DEFAULT_GROUP", new ArrayList<>(), true));
```

--------------------------------

### getConfigHistoryInfo Usage Example

Source: https://nacos.io/docs/latest/manual/admin/maintainer-sdk

Example demonstrating how to retrieve the first historical version of a configuration.

```java
try {
    # 查询`maintain.client.test`配置的历史版本列表。
    Page<ConfigHistoryBasicInfo> configHistoryBasicInfoPage = configMaintainerService.listConfigHistory("maintain.client.test", Constants.DEFAULT_GROUP, Constants.DEFAULT_NAMESPACE_ID, 1, 10);
    int nid = configHistoryBasicInfoPage.getPageItems().get(0).getId();
    # 查询`maintain.client.test`配置的历史版本列表中第一个历史版本的详细信息。
    ConfigHistoryDetailInfo result = configMaintainerService.getConfigHistoryInfo("maintain.client.test", Constants.DEFAULT_GROUP, Constants.DEFAULT_NAMESPACE_ID, nid);
} catch (NacosException e) {
    e.printStackTrace();
}
```

--------------------------------

### Get Console Guide Information

Source: https://nacos.io/docs/latest/manual/admin/console-api

Retrieves the Nacos console guide information. This is typically called when the console UI is disabled.

```bash
curl -X GET 'http://127.0.0.1:8080/v3/console/server/guide'
```

```json
{
  "code": 0,
  "message": "success",
  "data": "当前节点已关闭Nacos开源控制台使用，请修改application.properties中的nacos.console.ui.enabled参数为true打开开源控制台使用，详情查看<a href=\"https://nacos.io/zh-cn/docs/v2/guide/admin/console-guide.html\">文档</a>中关于<code>关闭默认控制台部分</code>。"
}
```

--------------------------------

### Subscribe Service with IP Selector Example

Source: https://nacos.io/docs/latest/manual/user/java-sdk/usage

Example of subscribing to a service using an IP selector that filters for instances starting with '127.0'.

```java
NamingService naming = NamingFactory.createNamingService(System.getProperty("serveAddr"));
EventListener serviceListener = event -> {
    if (event instanceof NamingEvent) {
        System.out.println(((NamingEvent) event).getServiceName());
        System.out.println(((NamingEvent) event).getInstances());
    }
};
// 只会选择订阅ip为`127.0`开头的实例。
NamingSelector selector = NamingSelectorFactory.newIpSelector("127.0.*");
naming.subscribe("nacos.test.service", "DEFAULT_GROUP", selector, serviceListener);
```

--------------------------------

### Publish Configuration Example

Source: https://nacos.io/docs/latest/guide/user/sdk

Initializes the ConfigService and publishes a configuration using the specified server address, dataId, and group.

```java

try {
    // 初始化配置服务，控制台通过示例代码自动获取下面参数
  String serverAddr = "{serverAddr}";
  String dataId = "{dataId}";
  String group = "{group}";
  Properties properties = new Properties();
  properties.put("serverAddr", serverAddr);
 		ConfigService configService = NacosFactory.createConfigService(properties);
  boolean isPublishOk = configService.publishConfig(dataId, group, "content");
  System.out.println(isPublishOk);
} catch (NacosException e) {
    // TODO Auto-generated catch block
    e.printStackTrace();
}

```

--------------------------------

### batchUploadSkillsFromZip Usage Example

Source: https://nacos.io/docs/latest/manual/admin/maintainer-sdk

Example demonstrating how to read a ZIP file and perform a batch upload of Skills.

```java
try {
    SkillMaintainerService skillMaintainerService = aiMaintainerService.skill();
    byte[] zipBytes = Files.readAllBytes(Paths.get("skills.zip"));
    BatchUploadResult result = skillMaintainerService.batchUploadSkillsFromZip(zipBytes);
    result = skillMaintainerService.batchUploadSkillsFromZip("public", zipBytes, true);
} catch (NacosException e) {
    e.printStackTrace();
}
```

--------------------------------

### Get AgentSpec API

Source: https://nacos.io/docs/latest/manual/user/open-api

Example request and response for retrieving details of a specific AgentSpec.

```bash
curl -X GET '127.0.0.1:8848/nacos/v3/client/ai/agentspecs?name=my-agent'
```

```json
{
  "code": 0,
  "message": "success",
  "data": {}
}
```

--------------------------------

### Query Service List Request

Source: https://nacos.io/docs/latest/manual/admin/admin-api

Example request to list all services using the GET method.

```bash
curl -X GET 'http://127.0.0.1:8848/nacos/v3/admin/ns/service/list'
```

--------------------------------

### Release MCP Service Example

Source: https://nacos.io/docs/latest/manual/user/java-sdk/usage

Demonstrates how to release an MCP service with basic specifications and optional resource configurations.

```java
Properties properties = new Properties();
properties.setProperty(PropertyKeyConst.SERVER_ADDR, "{serverAddr}");
AiService aiService = AiFactory.createAiService(properties);
try {
    McpServerBasicInfo serverSpecification = buildMcpSeverSpec(mcpName, version, isLatest);
    McpToolSpecification toolSpecification = buildTools();
    System.out.println(aiService.releaseMcpServer(serverSpecification, toolSpecification));


    McpResourceSpecification resourceSpecification = buildResources();
    System.out.println(aiService.releaseMcpServer(serverSpecification, toolSpecification, resourceSpecification, null));
} catch (Exception e) {
    e.printStackTrace();
}
```

--------------------------------

### Query Service Details Request

Source: https://nacos.io/docs/latest/manual/admin/admin-api

Example request to retrieve details for a specific service using the GET method.

```bash
curl -X GET 'http://127.0.0.1:8848/nacos/v3/admin/ns/service?serviceName=nacos.test.1'
```

--------------------------------

### createLocalMcpServer usage example

Source: https://nacos.io/docs/latest/manual/admin/maintainer-sdk

Demonstrates various ways to invoke the createLocalMcpServer method, including basic and detailed configuration approaches.

```java
try {
    String result = aiMaintainerService.createLocalMcpServer("test", "1.0.0");
    result = aiMaintainerService.createLocalMcpServer("test", "1.0.0", "test for mcp server");
    result = aiMaintainerService.createLocalMcpServer("test", "1.0.0", "test for mcp server", null);
    result = aiMaintainerService.createLocalMcpServer("test", "1.0.0", "test for mcp server", Collections.emptyMap(), null);
    McpServerBasicInfo mcpSpec = new McpServerBasicInfo();
    mcpSpec.setName("test");
    mcpSpec.setProtocol(AiConstants.Mcp.MCP_PROTOCOL_STDIO);
    mcpSpec.setDescription("test for mcp server");
    mcpSpec.setLocalServerConfig(Collections.emptyMap());
    ServerVersionDetail versionDetail = new ServerVersionDetail();
    versionDetail.setVersion("1.0.0");
    mcpSpec.setVersionDetail(versionDetail);
    result = aiMaintainerService.createLocalMcpServer("test", mcpSpec, null);
} catch (NacosException e) {
    e.printStackTrace();
}
```

--------------------------------

### Query MCP Service List Request

Source: https://nacos.io/docs/latest/manual/admin/console-api

Example request to list MCP services hosted on Nacos using a GET request.

```bash
curl -X GET 'http://127.0.0.1:8080/v3/console/ai/mcp/list?pageNo=1&pageSize=100&namespaceId=public&search=blur'
```

--------------------------------

### Query Configuration History List via GET

Source: https://nacos.io/docs/latest/guide/user/open-api

Example request and response for retrieving the history of a configuration using the /nacos/v2/cs/history/list endpoint.

```bash
curl -X GET 'http://127.0.0.1:8848/nacos/v2/cs/history/list?dataId=nacos.example&group=com.alibaba.nacos&namespaceId='
```

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "totalCount": 1,
    "pageNumber": 1,
    "pagesAvailable": 1,
    "pageItems": [
      {
                "id": "203",
                "lastId": -1,
                "dataId": "nacos.example",
                "group": "com.alibaba.nacos",
                "tenant": "",
                "appName": "",
                "md5": "9f67e6977b100e00cab385a75597db58",
          "content": "contentTest",
                "srcIp": "0:0:0:0:0:0:0:1",
                "srcUser": null,
                "opType": "I",
                "createdTime": "2010-05-04T16:00:00.000+0000",
                "lastModifiedTime": "2020-12-05T01:48:03.380+0000"
      }
    ]
  }
}
```

--------------------------------

### Query Pipeline Execution Records List (GET /nacos/v3/admin/ai/pipelines)

Source: https://nacos.io/docs/latest/manual/admin/admin-api

Example request and response for querying a paginated list of Pipeline execution records.

```bash
curl -X GET 'http://127.0.0.1:8848/nacos/v3/admin/ai/pipelines?resourceType=agentspec&resourceName=my-agentspec&namespaceId=public&version=1.0.0&pageNo=1&pageSize=20'
```

```json
{
  "code": 0,
  "message": "success",
  "data": {}
}
```

--------------------------------

### uploadSkillFromZip usage example

Source: https://nacos.io/docs/latest/manual/admin/maintainer-sdk

Example demonstrating various ways to upload a Skill from a ZIP file using the SkillMaintainerService.

```java
try {
    SkillMaintainerService skillMaintainerService = aiMaintainerService.skill();
    byte[] zipBytes = Files.readAllBytes(Paths.get("my-skill.zip"));
    String name = skillMaintainerService.uploadSkillFromZip("public", zipBytes, true);
    name = skillMaintainerService.uploadSkillFromZip("public", zipBytes, true, "1.0.1");
    name = skillMaintainerService.uploadSkillFromZip("public", zipBytes, true, "1.0.1", "upload skill");
    name = skillMaintainerService.uploadSkillFromZip("public", zipBytes);
    name = skillMaintainerService.uploadSkillFromZip(zipBytes);
} catch (NacosException e) {
    e.printStackTrace();
}
```

--------------------------------

### updateMcpServer usage example

Source: https://nacos.io/docs/latest/manual/admin/maintainer-sdk

Demonstrates how to configure McpServerBasicInfo and invoke the various updateMcpServer method overloads.

```java

try {
    McpServerBasicInfo mcpSpec = new McpServerBasicInfo();
    mcpSpec.setName("test");
    mcpSpec.setDescription("test for mcp server");
    mcpSpec.setProtocol(AiConstants.Mcp.MCP_PROTOCOL_STDIO);
    Map<String, Object> localServerConfig = Collections.singletonMap("test", new HashMap<>());
    mcpSpec.setLocalServerConfig(localServerConfig);
    ServerVersionDetail versionDetail = new ServerVersionDetail();
    versionDetail.setVersion("1.0.1");
    mcpSpec.setVersionDetail(versionDetail);
    boolean result = aiMaintainerService.updateMcpServer("test", mcpSpec, null, null);
    result = aiMaintainerService.updateMcpServer("test", true, null, null, null);
    result = aiMaintainerService.updateMcpServer("public", "test", true, null, null, null);
    result = aiMaintainerService.updateMcpServer("public", "test", true, null, null, null, false);
} catch (NacosException e) {
    e.printStackTrace();
}

```
Tokens:
Raw