GetNacosMcpServer - Microservices Engine

取得 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		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
	any		{"type":"object","properties":{"name":{"type":"string","description":"name"}}}
ToolsMeta	object
	object
Enabled	boolean		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
400	InvalidParameter	Parameter error:%s
500	InternalError	Console error. Try again later:%s
403	NoPermission	You are not authorized to perform this operation:%s
404	NotFound	Not found:%s

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。