阿里云百炼 MCP 快速入门

更新时间:2025-04-25 09:39:48

您可以开通阿里云百炼预置的 MCP 服务,也可以部署来自开源社区或其他来源的自定义 MCP 服务,并在智能体和工作流应用中使用这些 MCP 服务。

开通阿里云百炼预置的 MCP 服务

开通后,您可以使用阿里云百炼预置的 MCP 服务。以“开通 Amap Maps MCP 服务”为例:

说明

目前 Amap Maps MCP 服务限时免费使用。

  1. 前往MCP 广场,点击 Amap Maps 卡片。

    image

  2. 点击“立即开通”,确认后即可开通 Amap Maps MCP 服务。

    image

接入智能体应用和工作流应用

您可以通过阿里云百炼智能体应用和工作流应用使用 MCP 服务。

智能体应用

在智能体应用中,大模型会根据用户的问题,智能判断是否调用 MCP 服务。

  1. 创建智能体

    前往阿里云百炼应用管理,打开一个智能体应用。

    image

  2. 添加 MCP 服务

    智能体在回答时可以调用多个 MCP 服务。您可以同时添加至多 5 个 MCP 服务

    image

  3. 测试 MCP 服务

    现在,智能体可以自动调用合适的 MCP 服务解决您的实际问题。您可以参考以下几个使用场景:

    路程规划(单 MCP 服务)
    逐步思考(单 MCP 服务)
    气温趋势(多 MCP 服务)

    请确认已添加 Amap Maps MCP 服务,帮助智能体获取地理信息。

    在右侧对话窗格中发送一条测试消息:“现在出发,从杭州萧山国际机场到杭州西湖景区。请你提供三种公共交通出行方案”。您将看到智能体多次调用 MCP 服务,完成路径规划和时间估算。

    image

    请确认已添加 Sequential Thinking MCP 服务,帮助智能体逐步思考逻辑推理问题。

    在右侧对话窗格中发送一条测试消息:“请你解答这道“鸡兔同笼”问题:假设共有头12个,脚32只,请问鸡兔各有几何?”。您将看到智能体多次调用 MCP 服务,完成逻辑推理任务。

    image

    请确认已添加 Amap Maps 和 QuickChart MCP 服务,帮助智能体获取实时天气预报,并用折线图展示气温变化趋势。

    在右侧对话窗格中发送一条测试消息:“请使用折线图绘制杭州未来几天的气温走势”。您将看到智能体多次调用 MCP 服务,完成天气查询和图表绘制任务。

    image

工作流应用

MCP 服务可能有多个工具。在工作流应用中,每个 MCP 节点只能使用一个工具。您需要手动指定 MCP 节点的输入参数,再传递输出参数到下一个节点。

使用“Amap Maps”MCP 服务的“maps_weather工具,您可以快速构建一个城市天气查询工作流。

为了快速构建工作流,示例工作流无法回答与天气查询无关的问题。
  1. 创建工作流

    前往阿里云百炼应用管理,新建一个对话型工作流应用。

    image

  2. 设置开始节点

    在这个案例中,我们只需要默认的系统变量,故删去这两个参数。

    删除开始节点的两个默认参数。

    image

  3. 提取城市名称

    这一步将用户的自然语言解析为 MCP 节点需要的城市名称。

    从左侧工具栏中拖入一个大模型节点,命名为“信息提取”。请将此节点连接到开始节点,并按照指引填写参数。

    除以下参数外,其他参数保持默认即可:

    参数名

    参数值

    参数名

    参数值

    模型配置

    通义千问-Max

    System Prompt

    你是一个信息提取专家,你的任务是帮助“查询天气工具”解析正确的输入参数。

    ---

    “查询天气工具”的描述如下:

    名称:maps_weather

    描述:根据城市名称或者标准adcode查询指定城市的天气

    输入参数:city [string] 城市名称或者adcode

    输出参数:result [string] 城市的天气预报

    ---

    你的输出是“查询天气工具”的输入,你只需要输出城市的名称即可。

    注意:你一次只能输出一个城市。

    User Prompt

    您需要键入"/"来呼出变量菜单,选中“系统变量 > query

    说明

    使用 MCP 节点前,您通常需要将用户的自然语言转换为 MCP 节点的输入参数。因此,您需要在 System Prompt 里描述 MCP 服务的功能和输入输出信息,限定大模型的输出格式。

    image

  4. 查询天气信息

    使用高德 MCP 服务提供的天气查询工具,接收一个城市名,返回该城市的天气信息。

    从左侧工具栏中拖入一个 MCP 节点,按照图示选择 maps_weather 工具,确认节点配置。

    image

    请将 MCP 节点命名为“天气查询工具”,然后将此节点连接到“信息提取”节点。

    说明

    点击节点左上角的箭头按钮,即可展开或收起节点配置。

    image

    点击 MCP 节点内 maps_weather 工具的配置按钮,修改输入为“引用:信息提取/result”。

    image

  5. 总结天气信息

    将 MCP 服务返回的结果整理成自然语言,方便用户阅读。

    从左侧工具栏中拖入一个大模型节点,命名为“信息总结”。请将此节点连接到“天气查询工具”节点,并按照指引填写参数。

    除以下参数外,其他参数保持默认即可:

    参数名

    参数值

    参数名

    参数值

    模型配置

    通义千问-Max

    System Prompt

    你是一个信息处理助手,你的任务是将用户输入的信息整合为自然语言。

    User Prompt

    您需要键入"/"来呼出变量菜单,选中“天气查询工具 > result

    image

  6. 输出查询结果

    将结果传递到结束节点后,用户才可以看到天气信息。

    请将此节点连接到“信息总结”节点,并按照指引填写参数。

    除以下参数外,其他参数保持不变。

    参数名

    参数值

    参数名

    参数值

    输入框

    键入"/"来呼出变量菜单,选中“信息总结 > result

    image

  7. 测试查询效果

    点击右上角“测试”按钮,输入“查询杭州天气”,即可看到工作流输出“杭州”的天气信息。

    image

部署自定义 MCP 服务

除了预置的 MCP 服务,您还可以部署开源社区和自行开发的 MCP 服务。阿里云百炼会将您的 MCP 服务部署至阿里云函数计算 FC

以部署开源社区的 Knowledge Graph Memory MCP 服务为例:

Knowledge Graph Memory MCP 服务:通过此 MCP 服务,大模型可以记住您的个性化信息,并在回复时使用这些记忆。
  1. 创建 MCP 服务

    前往MCP 管理,点击创建 MCP 服务

  2. 配置 MCP 服务

    按照以下指引填写配置,确认无误后提交部署。

    配置项

    用途

    本案例的配置

    配置项

    用途

    本案例的配置

    服务名称

    描述

    为了区分多个 MCP 服务,不会影响大模型的判断和调用。

    服务名称:长期记忆

    描述:通过此 MCP 服务,大模型可以记住您的个性化信息,并在回复时使用这些记忆。

    安装方式

    如果您需要托管本地 MCP 服务(stdio):

    • npx:启动使用 Node.js 开发的 MCP 服务

    • uvx:启动使用 Python 开发的 MCP 服务。

    如果您需要连接远程 MCP 服务(SSE):

    • SSE:连接到一个已有的、运行在别处的远程 MCP 服务器。

    选择:npx

    部署方式

    (仅限 npx/uvx)

    如果您希望托管服务按需启动、节省成本、可以承受较慢响应,请保持基础模式:按次计费

    如果您希望托管服务持续运行、快速响应、可以承受较高成本,请开启极速模式

    详细计费规则请参考计费说明

    保持基础模式:按次计费,关闭极速模式

    部署地域

    (仅限 npx/uvx)

    为获得最佳响应速度,建议选择靠近您其他云服务的地域。若您不确定如何选择,推荐使用“北京”地域。

    选择:北京

    MCP 服务配置

    如果使用开源社区的 MCP 服务,请粘贴 MCP 服务详情页提供的配置代码。

    重要

    并非所有 MCP 服务都支持 npx/uvx/SSE 方式部署。若缺少相应配置代码,则无法直接部署到阿里云百炼。建议参考 MCP 官方文档进行本地部署。

    如果使用自己开发的 MCP 服务,请使用以下模板编写配置代码。

    {
      "mcpServers": {
        "本地 MCP 示范": {
          "type": "stdio",
          "command": "npx/uvx",
          "args": [
            "-y",
            "@your_acc_name/your_pkg_name"
          ],
          "env": {
            "YOUR_API_KEY": "your-api-key"
          }
        },
        "远程 MCP 示范": {
          "type": "sse",
          "url": "https://your-mcp-server/sse",
          "headers": {
            "Authorization": "Bearer ${your-api-key}",
          }
        }
      }
    }
    阿里云百炼将按照配置的命令和参数启动 MCP 服务。

    直接使用以下配置代码:

    {
      "mcpServers": {
        "memory": {
          "command": "npx",
          "args": [
            "-y",
            "@modelcontextprotocol/server-memory"
          ]
        }
      }
    }

    或在MCP 广场找到这个 MCP 服务,单击进入详情页,找到标题为 NPX 的配置代码。

  3. 管理 MCP 服务

    提交部署后,您可以查看部署状态,测试工具效果,以及修改服务配置。

    1. 查看部署状态

      您可以前往函数计算 FC 控制台查看 MCP 服务的详细部署状态。

      image

      (可选)推荐您启用日志服务,方便实时查看服务运行状态,排查可能出现的错误。

      image

      说明

      函数计算 FC 的日志服务会产生一定费用,详情请参考控制台的日志服务计费说明。

    2. 测试工具效果:

      您可以在工具页测试 MCP 服务的工具运行效果

      image

    3. 修改服务配置:

      部署后,您只能编辑服务名称描述。如需修改部署方式部署地域安装方式MCP 服务配置,您需要先停止当前部署,修改完成后再重新提交部署。

  4. 使用 MCP 服务

    部署完成后,您可以将自定义 MCP 服务接入智能体应用和工作流应用

  • 本页导读 (1)
  • 开通阿里云百炼预置的 MCP 服务
  • 接入智能体应用和工作流应用
  • 智能体应用
  • 工作流应用
  • 部署自定义 MCP 服务
AI助理

点击开启售前

在线咨询服务

你好,我是AI助理

可以解答问题、推荐解决方案等