1Panel + MaxKB 对接高德地图 MCP Server

一、场景说明:

通过 1Panel+MaxKB 两个开源工具实现高德地图(Amap) MCP 服务调用。

二、操作说明

步骤一:完成 1Panel 的安装部署

安装说明:在线安装 - 1Panel 文档:https://1panel.cn/docs/

步骤二:通过 1Panel 完成 MaxKB 的安装部署

安装说明:1Panel 安装 - MaxKB 文档:https://maxkb.cn/docs/installation/1panel_installtion/

步骤三:通过 1Panel 完成 Amap MCP 服务发布
  • 第一:查找 Amap Maps Server
    访问 https://mcp.so/ 查找 Amap Maps Server

  • 第二:获取 Amap Maps Server 的 Content
    切换到 Content 点击【复制 key】

  • 第三:登录 1Panel 平台【创建 MCP Server】
    进入 MCP 菜单,然后点击【创建 MCP Server】,如下图所示

    点击【导入MCP Server 配置】,将第二步复制的 KEY 粘贴进去

  • 第四:进入高德地图官网获取高德地图的key
    访问高德地图官网 https://console.amap.com/dev/key/app ,并替换复制到 1Panel 上的高德地图 key 值,并点击确认。

  • 第五:完成 MCP Server 信息配置并发布服务
    其中环境变量、挂载、容器名称、SSE 路径 1Panel 系统默认自动生成,需要输入 MCP Server 使用的端口、并打开端口外部访问,同时输入外部访问路径:IP:端口即可,输入完成后点击保存。等待片刻后服务发布成功。

步骤四:通过 MaxKB 添加 Amap MCP 服务工具
  • 第一:创建高级编排
    创建高级编排,添加 MCP 工具,如下图所示

  • 第二:设置 MCP 服务工具
    1、节点设置:从 1Panle 中获取服务外部链接地址,参考如下内容复制进去即可。

    {
        "amap-maps": {
          "url": "http://IP:端口/MCPserver名称",
          "transport":"sse"
        }
      }
    

    2、获取工具,点击 MCP 调用工具中的【获取工具】按钮,然后工具下拉框,获取相关工具,可参考高德 API 地图文档(https://lbs.amap.com/api/mcp-server/summary)说明,了解每个工具的作用说明。然后下来工具选择你需要的工具。

    3、工具参数:根据编排流程定义工具参数,可以直接应用也可自定义。

  • 第三:添加一个AI对话节点
    添加一个 AI 对话节点,并配置提示词,保存后开始调试。

步骤五:调用 Amap MCP Server 进行调试

测试一:上海市兆丰环球大厦附近有什么地方可以吃饭?

测试二: 搜索上海市宜山路地铁站哪里有空置的办公楼可以租赁?

原创作者: xiaobaiysf 转载于: https://www.cnblogs.com/xiaobaiysf/p/18873828
### 高德地图 MCP 平台介绍 高德地图 MCP(Map Customization Platform)平台是一个面向开发者和企业用户的定制化地图服务解决方案,旨在提供灵活、高效的地图服务能力。该平台现已覆盖12大核心服务接口,涵盖全场景的地图服务需求,包括地理编码、逆地理编码、IP定位、天气查询、骑行路径规划、步行路径规划、驾车路径规划、公交路径规划、距离测量、关键词搜索、周边搜索以及详情搜索等[^1]。 MCP 平台的设计目标是帮助用户快速构建与集成自定义的地图服务逻辑,同时支持多种开发语言和工具链,以满足不同业务场景的需求。通过 MCP 协议和 Trae 编辑器的结合使用,可以实现从环境搭建到服务配置再到实际开发应用的全流程支持[^2]。 ### 使用指南 #### 1. **环境准备** 在开始使用 MCP 平台之前,需要完成以下准备工作: - 注册并获取高德地图开放平台账号。 - 创建项目并申请 API Key。 - 下载并安装 Trae 编辑器,这是用于配置 MCP 协议的核心工具。 Trae 编辑器提供了图形化界面,便于开发者快速设计服务逻辑。通过编辑器可以直观地配置服务端点、请求参数、响应处理规则等内容。 #### 2. **服务配置** MCP Server 的配置是关键步骤之一,主要涉及以下几个方面: - **服务接口选择**:根据业务需求选择所需的 12 大核心服务接口之一或多个组合。 - **数据源对接**:将本地数据或第三方服务数据接入到 MCP Server 中,以便进行数据融合与转换。 - **规则定义**:利用 MCP 协议定义请求转发规则、数据过滤策略、缓存机制等。 例如,若需实现一个基于地理编码的逆向查询服务,可通过 Trae 编辑器设置对应的输入字段(如经纬度),并指定输出格式(如 JSON 或 XML)。 #### 3. **本地测试与集成** 为了确保服务逻辑的正确性,在部署前应进行充分的本地测试。推荐使用 Python 进行模拟调用,验证 MCP Server 的响应是否符合预期。以下是一个简单的 Python 测试示例: ```python import requests # 设置 MCP Server 的地址和 API Key base_url = "https://mcpserver.amap.com/api/v1" api_key = "your_api_key_here" # 构造请求参数 params = { "key": api_key, "location": "116.397428,39.90923", "output": "json" } # 发送 GET 请求 response = requests.get(f"{base_url}/reverse_geocode", params=params) # 打印响应结果 print(response.json()) ``` 上述代码演示了如何通过 Python 调用 MCP Server 提供的逆地理编码接口,并打印返回的 JSON 数据。这种方式有助于在正式部署前发现潜在问题。 #### 4. **部署与上线** 完成测试后,可将 MCP Server 部署至生产环境。建议采用容器化方式(如 Docker)进行部署,以提高服务的可维护性和扩展性。此外,还需配置负载均衡器和监控系统,确保服务的高可用性与稳定性。 #### 5. **持续优化** 随着业务的发展,可能需要对 MCP Server 进行持续优化。可以通过以下方式进行改进: - **性能调优**:调整线程池大小、连接超时时间等参数,提升服务吞吐量。 - **安全加固**:启用 HTTPS 加密传输,限制访问频率,防止恶意攻击。 - **日志分析**:收集并分析服务运行日志,及时发现异常行为。 ### 总结 高德地图 MCP 平台为开发者提供了一套完整的地图服务定制方案,不仅支持丰富的地图功能,还具备良好的灵活性与可扩展性。无论是小型项目还是大型企业级应用,都可以通过 MCP 平台快速构建出符合自身需求的地图服务。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值