Package com.alibaba.nacos.mcpregistry.controller

Class McpRegistryController

java.lang.Object

com.alibaba.nacos.mcpregistry.controller.McpRegistryController

@NacosApi
@RestController
@Extractor(httpExtractor=com.alibaba.nacos.ai.param.McpHttpParamExtractor.class)
public class McpRegistryController
extends Object

McpRegistryController.

Author:

xinluo

Constructor Summary

Constructors

Constructor	Description
McpRegistryController(NacosMcpRegistryService nacosMcpRegistryService)

Method Summary

Modifier and Type	Method	Description
Object	getServerVersions(String name, GetServerForm form, jakarta.servlet.http.HttpServletResponse response)	Get mcp server details.
Object	getVersionedServer(String serverName, String version, GetServerForm form, jakarta.servlet.http.HttpServletResponse response)	Get specific MCP server version.
com.alibaba.nacos.api.ai.model.mcp.registry.McpRegistryServerList	listMcpServers(ListServersNacosForm form)	List mcp servers.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

McpRegistryController

public McpRegistryController(NacosMcpRegistryService nacosMcpRegistryService)

Method Details

listMcpServers

@GetMapping("/v0/servers")
public com.alibaba.nacos.api.ai.model.mcp.registry.McpRegistryServerList listMcpServers(ListServersNacosForm form)
                                                                                 throws com.alibaba.nacos.api.exception.api.NacosApiException,
com.alibaba.nacos.api.exception.NacosException

List mcp servers. All server info is related to the latest version of the server.

Parameters:

form - list mcp servers request form Support blur and accurate search mode. default offset is 0 default limit is 30

Returns:

mcp server list McpRegistryServerList

Throws:

com.alibaba.nacos.api.exception.api.NacosApiException - if request parameter is invalid or handle error

com.alibaba.nacos.api.exception.NacosException

getServerVersions

@GetMapping("/v0/servers/{name}/versions")
public Object getServerVersions(@PathVariable
 String name,
 GetServerForm form,
 jakarta.servlet.http.HttpServletResponse response)
                         throws com.alibaba.nacos.api.exception.NacosException

Get mcp server details. If version is not provided, this api will return the latest version of the server.

Parameters:

name - server name

form - get server request form

response - HTTP response

Returns:

mcp server detail or McpErrorResponse when server not found.

Throws:

com.alibaba.nacos.api.exception.api.NacosApiException - if request parameter is invalid or handle error

com.alibaba.nacos.api.exception.NacosException

getVersionedServer

@GetMapping("/v0/servers/{serverName}/versions/{version}")
public Object getVersionedServer(@PathVariable
 String serverName,
 @PathVariable
 String version,
 GetServerForm form,
 jakarta.servlet.http.HttpServletResponse response)
                          throws com.alibaba.nacos.api.exception.NacosException

Get specific MCP server version. Returns detailed information about a specific version of an MCP server. Use the special version `latest` to get the latest version.

Parameters:

serverName - URL-encoded server name (e.g., "com.example%2Fmy-server")

version - URL-encoded version to retrieve (e.g., "1.0.0" or "1.0.0%2B20130313144700")

form - get server request form

response - HTTP response

Returns:

mcp server detail or McpErrorResponse when server or version not found.

Throws:

com.alibaba.nacos.api.exception.NacosException - if handle error