GetNacosMcpServer - 获取MCP Server详细信息 - 微服务引擎MSE

获取MCP Server的详情

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

mse:GetNacosMcpServer

get

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
InstanceId	string	否	实例 ID。	mse_prepaid_public_cn-tl327w****
NamespaceId	string	否	命名空间 ID。	5e3ee449-b5c0-4aee-b857-32c0acbebf26
McpServerId	string	否	MCP Server 的 Id	5e3c5211-d365-4013-8540-c4106ec2a5dc
McpServerVersion	string	否	MCP Server 的版本	1.0.0
AcceptLanguage	string	否	返回结果显示的语言。取值：zh（默认值）：中文，en：英文	zh

返回参数

名称	类型	描述	示例值
	object	RestResult
RequestId	string	请求 ID。	72FC625E-9629-591B-9C01-3F0BFDAB****
Data	object	返回数据。
RemoteServerConfig	object	Remote Server 配置
ServiceRef	object	服务引用
NamespaceId	string	命名空间 ID。	public
GroupName	string	服务所在的分组。	DEFAULT
ServiceName	string	服务名称。	mcp-service
ExportPath	string	对外暴露的路径	/sse
LocalServerConfig	object	Local MCP Server 的配置
	any	具体的 LocalServer 配置	{ "mcpServers": { "amap-mcp-server": { "description": "高德地图服务", "command": "npx", "args": [ "-y", "@amap/amap-maps-mcp-server" ], "env": { "AMAP_MAPS_API_KEY": "" } } } }
BackendEndpoints	array<object>	后端服务 endpoint
	object
Address	string	地址。	127.0.0.1
Port	integer	端口号	80
Path	string	路径。	/sse
ToolSpec	object	Tool 的描述
Tools	array<object>	工具列表
	array<object>	工具详情
Name	string	工具名称	get_weather
Description	string	描述说明。	a weather query tool
InputSchema	object	Tool 入参结构
	any	具体的参数结构	{"type":"object","properties":{"name":{"type":"string","description":"name"}}}
ToolsMeta	object	Tool 的元信息 MAP
	object	具体的元信息配置
Enabled	boolean	Tool 是否启用	true
Templates	object	协议转化模版配置
	any	具体的模版配置	{"requestTemplate":{"url":"https://api.example.com/endpoint/{{.args.NewArg1}}","method":"GET","headers":[{"key":"Authorization","value":"Bearer {{.security.token}}"}]},"responseTemplate":{"body":"{{.}}"},"argsPosition":{"NewArg1":"path"}}
SpecificationType	string
SecuritySchemes	any
ToolDecryptStatus	string
AllVersions	array<object>	当前 MCP Server 的所有版本信息
	object
Version	string	版本号。	1.0.9
Release_date	string	发布时间	2025-07-16
Is_latest	boolean	是否为最新版本	true
Enabled	boolean	该网关是否处于启用状态。 true：启用状态。 false：停用状态。	true
Id	string	ID。	5e3c5211-d365-4013-8540-c4106ec2a5dc
Name	string	名称。	mcp-demo
Description	string	描述。	描述
Protocol	string	协议。	mcp-sse
FrontProtocol	string	对外暴露的协议类型	mcp-sse
Capabilities	array	当前 MCP Server 的能力
	string	能力描述	TOOL
VersionDetail	object	版本明细
Version	string	版本号	1.11.0
ReleaseDate	string	发布时间	2025-07-16
IsLatest	boolean	是否为最新版本	true
YamlConfig	string	AI 网关 Yaml 配置。	allowTools: - demo-tool securityScheme: {} server: name: mcp-demo tools: - args: - name: name description: name type: string description: a demo tool name: demo-tool

示例

正常返回示例

JSON格式

{
  "RequestId": "72FC625E-9629-591B-9C01-3F0BFDAB****",
  "Data": {
    "RemoteServerConfig": {
      "ServiceRef": {
        "NamespaceId": "public",
        "GroupName": "DEFAULT",
        "ServiceName": "mcp-service"
      },
      "ExportPath": "/sse"
    },
    "LocalServerConfig": {
      "key": "{\n    \"mcpServers\":\n    {\n        \"amap-mcp-server\":\n        {\n            \"description\": \"高德地图服务\",\n            \"command\": \"npx\",\n            \"args\":\n            [\n                \"-y\",\n                \"@amap/amap-maps-mcp-server\"\n            ],\n            \"env\":\n            {\n                \"AMAP_MAPS_API_KEY\": \"\"\n            }\n        }\n    }\n}\n"
    },
    "BackendEndpoints": [
      {
        "Address": "127.0.0.1",
        "Port": 80,
        "Path": "/sse"
      }
    ],
    "ToolSpec": {
      "Tools": [
        {
          "Name": "get_weather",
          "Description": "a weather query tool",
          "InputSchema": {
            "key": "{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"name\"}}}"
          }
        }
      ],
      "ToolsMeta": {
        "key": {
          "Enabled": true,
          "Templates": {
            "key": "{\"requestTemplate\":{\"url\":\"https://api.example.com/endpoint/{{.args.NewArg1}}\",\"method\":\"GET\",\"headers\":[{\"key\":\"Authorization\",\"value\":\"Bearer {{.security.token}}\"}]},\"responseTemplate\":{\"body\":\"{{.}}\"},\"argsPosition\":{\"NewArg1\":\"path\"}}"
          }
        }
      },
      "SpecificationType": "",
      "SecuritySchemes": "",
      "ToolDecryptStatus": ""
    },
    "AllVersions": [
      {
        "Version": "1.0.9",
        "Release_date": "2025-07-16\n",
        "Is_latest": true
      }
    ],
    "Enabled": true,
    "Id": "5e3c5211-d365-4013-8540-c4106ec2a5dc",
    "Name": "mcp-demo",
    "Description": "描述",
    "Protocol": "mcp-sse",
    "FrontProtocol": "mcp-sse",
    "Capabilities": [
      "TOOL"
    ],
    "VersionDetail": {
      "Version": "1.11.0",
      "ReleaseDate": "2025-07-16",
      "IsLatest": true
    },
    "YamlConfig": "allowTools:\n- demo-tool\nsecurityScheme: {}\nserver:\n  name: mcp-demo\ntools:\n- args:\n  - name: name\n    description: name\n    type: string\n  description: a demo tool\n  name: demo-tool\n"
  }
}

错误码

HTTP status code	错误码	错误信息	描述
400	IllegalRequest	Invalid request:%s	非法请求： %s
400	InvalidParameter	Parameter error:%s	请求参数错误：%s
500	InternalError	Console error. Try again later:%s	控制台错误.稍后重试：%s
403	NoPermission	You are not authorized to perform this operation:%s	没有权限使用此接口：%s
404	NotFound	Not found:%s	资源不存在：%s

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。