通义灵码助你打造专属高德 MCP 服务

简介: 如果现有的MCP服务不满足您的需求,通义灵码智能体能够帮助您开发专属MCP服务,直达业务目标。本案例以高德提供的基础MCP服务为基础,借助智能体开发一个订制旅游攻略的高级MCP服务。

如果现有的MCP服务不满足您的需求,通义灵码智能体能够帮助您开发专属MCP服务,直达业务目标。本案例以高德提供的基础MCP服务为基础,借助智能体开发一个订制旅游攻略的高级MCP服务。


开发过程


点击视频查看开发过程:https://cloud.video.taobao.com/vod/qgg7pTSL23KMpoSZcdaHIniKiDzLNV5rpsOFngoAq88.mp4


如果您想快速体验开发完成后的效果,操作步骤如下:


1. 部署您的专属MCP服务


首先,您需要安装灵码插件登录


尽管您可以在MCP广场搜索或直接添加服务商提供的MCP服务,但更通用的做法是部署您的专属MCP服务,它可以通过灵活定制来贴合实际业务场景。


本地部署


本地部署支持Linux系统和macOS系统,Windows用户建议通过WSL运行Linux子系统来部署服务。


在命令行终端执行以下操作:


  1. 安装UV工具:curl -LsSf https://astral.sh/uv/install.sh | sh,您可以通过执行uv --version来验证安装成功。
  2. 部署MCP服务:

下载MCP服务示例代码git clone https://gitcode.com/aliyun_solution/amap_tour_guide_mcp_server.git && cd amap_tour_guide_mcp_server/

  • 如果报错提示未检测到git命令,需要先安装git
  • 如果您不希望安装git,可以直接在代码仓库页面下载压缩包,解压后在IDE中打开。
  1. 配置环境变量:
  1. 运行MCP服务:uv run python mcp_server.py


本地部署-通过Docker(推荐)


本地部署支持Linux系统和macOS系统,Windows用户建议通过WSL运行Linux子系统来部署服务。


在命令行终端执行以下操作:


  1. 准备运行环境:确保环境中已安装Docker,您可以通过执行docker --version来验证,如果返回报错信息,请安装Docker
  2. 部署MCP服务:
  1. 下载MCP服务示例代码git clone https://atomgit.com/lanxi1/amap_tour_guide_mcp_server.git && cd amap_tour_guide_mcp_server/。如果报错提示未检测到git命令,需要先安装git
  2. 构建并运行MCP服务:执行以下命令,注意将其中your_own_amap_key替换为您在高德申请的key;将其中your_own_dashscope_api_key替换为您的API Key


docker build -t amap_mcp_server:1.0 .
docker run -d -p 8000:8000 --name my_amap_mcp_server \
  -e AMAP_KEY='your_own_amap_key' \
  -e DASHSCOPE_API_KEY='your_own_dashscope_api_key' \
  amap_mcp_server:1.0


通过FC部署(推荐)


  1. 构建镜像:通过FC部署之前,您需要一台主机来构建MCP服务的镜像。可以使用Linux系统或macOS系统,Windows用户建议通过WSL运行Linux子系统来构建镜像。
  1. 确保环境中已安装Docker,您可以通过执行docker --version来验证,如果返回报错信息,请安装Docker
  2. 下载MCP服务示例代码git clone https://atomgit.com/lanxi1/amap_tour_guide_mcp_server.git && cd amap_tour_guide_mcp_server/
  3. 构建镜像:docker build --platform linux/amd64 -t amap_mcp_server:1.0 .
  1. 推送镜像:由于FC只能从同地域的ACR镜像仓库中拉取镜像,在部署前,需要先将镜像推送到目标部署地域下归属您的ACR镜像仓库。ACR支持个人版企业版,本文以个人版为例:
  1. 登录ACR控制台,点击个人版实例,在左侧导航栏选择镜像仓库,点击创建镜像仓库
  2. 自定义仓库名称摘要,点击下一步
  3. 代码源选择本地仓库,点击创建镜像仓库,然后根据页面提示推送镜像。
  1. 部署服务:
  1. 登录FC控制台,在页面顶部选择与ACR相同的地域,在左侧导航栏选择函数,点击创建函数。配置以下参数,其余保持默认,然后点击创建
  • 函数类型选择Web函数
  • 自定义函数名称
  • 运行环境选择自定义镜像 / 使用ACR中的镜像
  • 容器镜像选择您之前推送到ACR中的镜像。
  • 监听端口设置为8000
  • 环境变量中,添加变量如下:变量:AMAP_KEY,值:'your_own_amap_key';变量:DASHSCOPE_API_KEY,值:'your_own_dashscope_api_key'。注意将其中your_own_amap_key替换为您在高德申请的keyyour_own_dashscope_api_key替换为您的API Key,注意保留''
  1. 函数详情页,等待函数状态显示函数已激活,则说明服务已部署成功。点击HTTP触发器即可查看公网访问地址


通过ECS部署


  1. 创建ECS实例:登录ECS控制台,点击创建实例。配置以下参数,其余保持默认,然后点击确认下单
  1. 付费类型建议先尝试按量付费,后续可以随时更改。
  2. 实例规格建议选择ecs.e-c1m2.large
  3. 镜像选择Alibaba Cloud Linux 3.2104 LTS 64位
  4. 扩展程序选择Docker 社区版
  5. 公网 IP开启分配公网 IPv4 地址
  6. 登录凭证选择密钥对自定义密码,并完成相应配置,用于登录ECS实例。
  1. 部署MCP服务:等待ECS实例创建完成后,连接实例。在命令行终端执行以下操作:
  1. 下载MCP服务示例代码git clone https://atomgit.com/lanxi1/amap_tour_guide_mcp_server.git && cd amap_tour_guide_mcp_server/。如果报错提示未检测到git命令,需要先安装git
  2. 构建并运行MCP服务:执行以下命令,注意将其中your_own_amap_key替换为您在高德申请的key;将其中your_own_dashscope_api_key替换为您的API Key


docker build -t amap_mcp_server:1.0 .
docker run -d -p 8000:8000 --name my_amap_mcp_server \
  -e AMAP_KEY='your_own_amap_key' \
  -e DASHSCOPE_API_KEY='your_own_dashscope_api_key' \
  amap_mcp_server:1.0
  1. 开放ECS安全组端口:MCP Server运行在ECS实例的8000端口,为了使客户端可以从公网访问,需要为ECS安全组开放入方向的TCP 8000端口,授权对象列的设置为客户端的公网IP地址,如果不确定,可以暂时设置为0.0.0.0/0,表示允许所有IP访问。


2. 连接并调用MCP服务


  1. 为智能编码助手手动添加MCP服务,参数配置如下:
  1. 类型选择SSE
  2. 服务地址设置如下:
  • 如果是本地部署的,则为http://127.0.0.1:8000/mcp
  • 如果是通过FC部署的,则为/mcp,注意将其中用实际地址进行替换,不要保留<>,不要遗漏/mcp
  • 如果是通过ECS部署的,则为http://:8000/mcp,注意将其中用实际ECS公网IP进行替换,不要保留<>,不要遗漏/mcp


重要


后续对话过程中,如果出现MCP服务器断连的现象,请返回本页面,在MCP服务列表中点击对应服务的刷新按钮,确保服务恢复为连接状态。

  1. 返回会话窗口,设置模式为智能体,选择模型为qwen3,在对话框中输入以下提示词并回车:生成北京旅游攻略的html页面
  1. 观察大模型是否调用正确的工具并传入正确的参数,如果确认无误,则点击确认执行。
  2. 如果没有自动生成页面,则需要展开已执行MCP工具,点击执行结果中的复制按钮。手动创建名为output_tour_tips.html的文件,将内容粘贴到文件中并保存文件。
  3. 生成的页面可以在浏览器中打开。



重要


您部署的MCP服务依赖于远程调用高德平台提供的API、百炼平台提供的大模型文本生成服务,由于网络波动或大模型生成内容的随机性,可能导致MCP工具调用失败。通常等待一段时间后重新执行上述步骤,或稍微调整下提示词,即可执行成功。


3. 释放资源


若不继续使用MCP Server,则需要释放相关资源,避免产生额外费用:


  • 如果是通过ECS部署的,则需要释放ECS实例
  • 如果是通过FC部署的,在确保未开启预留实例功能的前提下,则无需删除函数,因为不调用服务就不会产生费用。


说明


想动手试试?作为开发者的您可以在本项目提供的代码基础上二次开发、深度定制,在此过程中也请积极尝试借助灵码来完成那些开发任务。即使业务差别很大,您也可以把代码的实现思路快速迁移到自身的业务领域中。以下提供一些思考和探索方向,期待您的参与:


  • 优化本例代码的架构、算法,完善异常捕获、日志记录等能力,使其具有更好的可维护性、执行效率、健壮性。
  • 当前生成的HTML内容以字符串形式返回结果,需要手动粘贴到HTML文件中。您可以尝试通过调用MCP服务来将内容自动保存为HTML文件,如果当前没有可用的MCP服务,可以尝试自己编写一个。
  • 当前生成的推荐景点是通过调用高德地图的关键字搜索API实现的,无法实现个性化定制和创造性内容的生成。您可以尝试通过MCP服务来实时捕捉社交平台上的旅游热点和推荐内容,并将其整合到定制旅游攻略时的决策链路中,如果当前没有可用的MCP服务,可以尝试自己编写一个。
相关文章
刚刚参加了一个MCP赛事,奖金还可以,搭友们可以去试试看
社区8月比赛未获奖有点失落,但发现通义灵码×蚂蚁百宝箱MCP赛事正火热进行!参赛即有机会赢取丰厚奖金,激励满满,令人眼前一亮。已跃跃欲试,搭友们快来一起冲榜夺奖吧!https://tianchi.aliyun.com/competition/entrance/532442
|
4月前
|
IDE 开发工具 Python
通义灵码+支付 MCP:30 分钟实现创作打赏智能体
本文介绍如何使用通义灵码智能体与 qwen3 和支付 MCP 编写创作打赏智能体,该智能体能够完成日常聊天、诗词创作和请求打赏并生成支付链接功能。
411 1
|
监控
使用云监控2.0页面诊断问题根因-错误分析指南
针对一次故障的根因诊断,通过云监控2.0调用链分析。
2413 0
|
8月前
|
人工智能 自然语言处理 小程序
蚂蚁百宝箱 3 分钟上手 MCP:6 步轻松构建 Qwen3 智能体应用并发布小程序
本文介绍如何用6个步骤、3分钟快速构建一个基于Qwen3与蚂蚁百宝箱MCP的智能体应用,并发布为支付宝小程序。通过结合Qwen3强大的语言理解和生成能力,以及支付宝MCP提供的支付功能,开发者可轻松打造具备商业价值的“数字员工”。案例以“全球智能导游助手”为例,支持119种语言,不仅提供旅行建议,还能收取用户打赏。文章详细说明了从登录百宝箱、创建应用、添加插件到配置角色、发布上架及手机端体验的完整流程,同时提醒当前支付功能仅适用于测试环境。适合希望探索AI应用变现潜力的开发者尝试。
1152 14
|
8月前
|
传感器 人工智能 IDE
AI IDE正式上线!通义灵码开箱即用
作为AI原生的开发环境工具,通义灵码AI IDE深度适配了最新的千问3大模型,并全面集成通义灵码插件能力,具备编程智能体、行间建议预测、行间会话等功能。
3048 16
|
5月前
|
人工智能 IDE 开发工具
通义灵码 AI IDE使用体验(3)项目优化及bug修复
本文介绍了使用通义灵码 AI IDE进行项目重构与优化的全过程,涵盖页面调整、UI更新、功能修复等内容,并展示了多次优化后的成果与仍存在的问题。
435 0
|
人工智能 运维 监控
2025 AI 原生编程挑战赛 数据获取文档
本文介绍了参赛者如何配置阿里云服务以参加AI运维赛。首先开通阿里云日志服务,随后创建RAM用户并为其分配访问权限。接着为该用户授权,确保其具备读取数据的权限。最后,可选地创建或重新生成AccessKey以用于后续的数据查询操作。整个流程帮助选手完成基础环境配置,以便使用阿里云日志服务进行数据分析。
2644 2
|
4月前
|
机器学习/深度学习 人工智能 机器人
AI Compass前沿速览:Nano Bananary、MCP Registry、通义DeepResearch 、VoxCPM、InternVLA·M1具身机器人
AI Compass前沿速览:Nano Bananary、MCP Registry、通义DeepResearch 、VoxCPM、InternVLA·M1具身机器人
|
6月前
|
人工智能 开发者
2025魔搭MCP&Agent挑战赛正式启动!50万总奖池!
2025魔搭MCP&Agent挑战赛正式拉开帷幕!这是一场聚焦MCP协议生态与Agent应用落地的顶级开发者盛会,旨在推动工具标准化与智能体场景创新,探索AI开发者在终端硬件的创新实践。
827 3