ListMcps - 查询 MCP 服务列表

接口说明

授权信息

请求语法

GET /workspaces/{workspaceId}/mcp-servers HTTP/1.1

路径参数

请求参数

返回参数

示例

正常返回示例

JSON格式

{
  "code": "Success",
  "httpStatusCode": 200,
  "items": [
    {
      "addresses": [
        "https://example.com/mcp"
      ],
      "auth": {
        "codePackage": {
          "apiKey": "example-api-key",
          "headerName": "X-API-Key"
        },
        "directProxy": {
          "name": "mcp-example",
          "value": "example-credential"
        },
        "enabled": true,
        "httpToMcp": [
          {
            "credential": "example-credential",
            "id": "mcp-1234567890abcdef",
            "name": "mcp-example",
            "position": "header",
            "type": "basic"
          }
        ]
      },
      "createdAt": "2026-08-23T00:00:00Z",
      "customTags": [
        "知识库"
      ],
      "deploymentConfig": {
        "accessControl": {
          "credentialId": "credential-id",
          "enabled": true,
          "mode": "CREDENTIAL"
        },
        "agentIdentityConfiguration": {
          "authorizationEnabled": true,
          "credentialProviderArn": "acs:agentidentity:cn-hangzhou:1234567890123456:provider/example",
          "credentialProviderType": "oauth2",
          "enabled": true
        },
        "artifactType": "Code",
        "codeConfiguration": {
          "codePackageToken": "upload-token",
          "command": [
            "python"
          ],
          "language": "python3.13"
        },
        "containerConfiguration": {
          "acrInstanceId": "cri-example",
          "command": [
            "python"
          ],
          "entrypoint": [
            "/bin/sh"
          ],
          "image": "registry.cn-hangzhou.aliyuncs.com/example/mcp:1.0.0",
          "imageRegistryType": "ACR",
          "mcpRuntimeMode": "SELF_HOSTED",
          "sourceType": "CONTAINER_IMAGE"
        },
        "hookConfiguration": {
          "hooks": [
            {
              "apiVersion": "1.0",
              "description": "记录 MCP 工具调用",
              "enabled": true,
              "event": "PRE_CALL_TOOL",
              "headers": {
                "key": "application/json"
              },
              "timeout": 3000,
              "url": "https://example.com/mcp-hook"
            }
          ]
        },
        "logConfiguration": {
          "enableInstanceMetrics": true,
          "enableRequestMetrics": true,
          "logBeginRule": "DefaultRegex",
          "logstore": "mcp-logs",
          "project": "agentcore-mcp-logs"
        },
        "mcpConfiguration": {
          "endpointPath": "/mcp",
          "sessionConcurrencyPerInstance": 1,
          "sessionIdleTimeoutSeconds": 1800,
          "sessionMaxLifetimeSeconds": 21600
        },
        "nasConfiguration": {
          "groupId": 1000,
          "mountPoints": [
            {
              "enableTls": true,
              "mountDir": "/mnt/data",
              "serverAddr": "example.cn-hangzhou.nas.aliyuncs.com"
            }
          ],
          "userId": 1000
        },
        "networkConfiguration": {
          "networkMode": "PUBLIC",
          "securityGroupId": "sg-example",
          "vSwitchIds": [
            "vsw-example"
          ],
          "vpcId": "vpc-example"
        },
        "ossMountConfiguration": {
          "mountPoints": [
            {
              "bucketName": "example-bucket",
              "bucketPath": "/data",
              "endpoint": "https://oss-cn-hangzhou.aliyuncs.com",
              "mountDir": "/mnt/data",
              "readOnly": true
            }
          ]
        },
        "parameterTransformConfiguration": {
          "enabled": true,
          "ruleSetId": "rules-1",
          "version": "1.0"
        },
        "proxyConfiguration": {
          "enabled": true
        },
        "runtimeConfiguration": {
          "cpu": 0.25,
          "diskSize": 512,
          "environmentVariables": {
            "key": "production"
          },
          "executionRoleArn": "acs:ram::1234567890123456:role/agentcore-mcp-execution",
          "instanceConcurrency": 200,
          "memory": 512,
          "port": 9000,
          "timeout": 300
        }
      },
      "description": "用于说明资源用途的示例描述。",
      "endpoint": "https://example.com/mcp",
      "functionName": "agentcore-mcp-example",
      "marketSource": {
        "marketItemId": "market-1"
      },
      "mcpServerId": "mcp-1234567890abcdef",
      "name": "mcp-example",
      "officialTag": "KNOWLEDGE_BASE",
      "permissionMode": "CONTROLLED",
      "protocol": "SSE",
      "status": "CREATING",
      "statusReason": "资源处理完成",
      "swaggerConfig": "{\"type\":\"object\"}",
      "type": "file",
      "updatedAt": "2026-08-23T01:00:00Z",
      "usageActive": true
    }
  ],
  "maxResults": 20,
  "message": "请求处理成功",
  "nextToken": "next-page-token",
  "requestId": "A1B2C3D4-E5F6-47A8-90AB-CDEF12345678",
  "success": true,
  "totalCount": 100
}

错误码

变更历史