GetNacosMcpServer - Microservices Engine - Alibaba Cloud ドキュメントセンター

MCP サーバーの詳細を取得します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

mse:GetNacosMcpServer

get

*すべてのリソース。

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
InstanceId	string	任意	インスタンスの ID。	mse_prepaid_public_cn-tl327w****
NamespaceId	string	任意	名前空間の ID。	5e3ee449-b5c0-4aee-b857-32c0acbebf26
McpServerId	string	任意	MCP サーバーの ID。	5e3c5211-d365-4013-8540-c4106ec2a5dc
McpServerVersion	string	任意	MCP サーバーのバージョン。	1.0.0
AcceptLanguage	string	任意	返される結果の言語。有効な値: zh (デフォルト): 中国語、en: 英語。	zh

レスポンスフィールド

フィールド	型	説明	例
	object	RestResult
RequestId	string	リクエスト ID。	72FC625E-9629-591B-9C01-3F0BFDAB****
Data	object	返されたデータ。
RemoteServerConfig	object	リモートサーバーの構成。
ServiceRef	object
NamespaceId	string		public
GroupName	string		DEFAULT
ServiceName	string		mcp-service
ExportPath	string		/sse
LocalServerConfig	object	ローカル MCP サーバーの構成。
	any	特定のローカルサーバー構成。	{ "mcpServers": { "amap-mcp-server": { "description": "Amap マップサービス", "command": "npx", "args": [ "-y", "@amap/amap-maps-mcp-server" ], "env": { "AMAP_MAPS_API_KEY": "" } } } }
BackendEndpoints	array<object>	バックエンドサービスのエンドポイント。
	object
Address	string		127.0.0.1
Port	integer		80
Path	string		/sse
ToolSpec	object	ツールのスペック。
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 サーバーのすべてのバージョン情報。
	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 サーバーの機能。
	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: 名前 type: string description: デモツール name: demo-tool

例

成功レスポンス

JSONJSON

{
  "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 ステータスコード	エラーコード	エラーメッセージ
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

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。