ListMcpMarketItems - 查询 MCP 市场模板列表-智能体构建和治理平台 AgentCore-阿里云帮助中心

查询 MCP 市场模板

接口说明

查询所有在线官方 MCP 模板，支持按关键词、用途标签和 MCP 类型筛选。

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

agentcore:ListMcpMarketItems

list

*Mcp

acs:agentcore:{#regionId}:{#accountId}:workspace/{#workspaceId}/mcp/*

无

请求语法

GET /workspaces/{workspaceId}/mcp-market/items HTTP/1.1

路径参数

名称	类型	必填	描述	示例值
workspaceId	string	是	AgentCore 工作空间 ID。	workspace-id

请求参数

名称	类型	必填	描述	示例值
keyword	string	否	用于筛选 MCP 市场模板的关键词。	Knowledge
officialTag	string	否	官方用途标签。	KNOWLEDGE_BASE
mcpType	string	否	MCP 类型。	CODE_PACKAGE
maxResults	integer	否	本次查询最多返回的记录数。	20
nextToken	string	否	查询下一页的分页标记。	20

返回参数

名称	类型	描述	示例值
	object
code	string	业务状态码。	SUCCESS
httpStatusCode	integer	HTTP 状态码。	200
items	array<object>	查询结果列表。
	array<object>
category	string	MCP 市场模板分类。	knowledge
description	string	MCP 服务描述。	用于查询知识库的 MCP 服务
displayMetadata	object	模板展示元数据。
i18n	object	多语言展示内容，按 BCP-47 语言标签组织；未命中语言时回退到默认字段。
	object	对应语言的名称、描述和使用说明。
description	string	该语言下的 MCP 服务描述。	用于查询知识库的 MCP 服务
name	string	该语言下的 MCP 市场模板名称。	知识库
readme	string	该语言下的 MCP 市场模板使用说明。	# 知识库\n知识库查询服务。
iconUrl	string	MCP 市场模板的图标地址。	https://example.com/mcp-icon.png
installCount	integer	模板安装次数。	12
marketItemId	string	MCP 市场模板 ID。	market-1
mcpType	string	MCP 类型。	CODE_PACKAGE
name	string	MCP 市场模板名称。	Knowledge
officialTag	string	官方用途标签。	KNOWLEDGE_BASE
protocol	string	MCP 协议。	StreamableHTTP
readme	string	MCP 市场模板的使用说明。	# Knowledge\n知识库查询服务。
schemaVersion	string	模板 Schema 版本。	1.0
templateInputSchema	string	模板输入 Schema，采用 JSON Schema 字符串表示。	{"type":"object","properties":{"addresses":{"type":"array","items":{"type":"string"}}}}
templateVersion	string	MCP 市场模板版本。	1.0.0
maxResults	integer	本次查询最多返回的记录数。	20
message	string	响应消息。	success
nextToken	string	查询下一页的分页标记。	20
requestId	string	请求 ID，用于定位和排查请求。	request-123456
success	boolean	请求是否成功。
totalCount	integer	符合条件的记录总数。	12

示例

正常返回示例

JSON格式

{
  "code": "SUCCESS",
  "httpStatusCode": 200,
  "items": [
    {
      "category": "knowledge",
      "description": "用于查询知识库的 MCP 服务",
      "displayMetadata": {
        "test": "test",
        "test2": 1
      },
      "i18n": {
        "key": {
          "description": "用于查询知识库的 MCP 服务",
          "name": "知识库",
          "readme": "# 知识库\\n知识库查询服务。"
        }
      },
      "iconUrl": "https://example.com/mcp-icon.png",
      "installCount": 12,
      "marketItemId": "market-1",
      "mcpType": "CODE_PACKAGE",
      "name": "Knowledge",
      "officialTag": "KNOWLEDGE_BASE",
      "protocol": "StreamableHTTP",
      "readme": "# Knowledge\\n知识库查询服务。",
      "schemaVersion": "1.0",
      "templateInputSchema": "{\"type\":\"object\",\"properties\":{\"addresses\":{\"type\":\"array\",\"items\":{\"type\":\"string\"}}}}",
      "templateVersion": "1.0.0"
    }
  ],
  "maxResults": 20,
  "message": "success",
  "nextToken": "20",
  "requestId": "request-123456",
  "success": true,
  "totalCount": 12
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidParameter	An MCP market query parameter is invalid.
404	Resource.NotFound	The specified workspace does not exist.

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

变更历史

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