返回 MCP 目录
public公开dns本地运行

MCPServerTest

介绍如何使用高德地图MCP Server实现LLM与地图服务的交互

article

README

🚀 地图服务项目文档

本项目提供了一系列地图服务功能接口,涵盖地理编码、地标查询、IP定位等多种服务。同时,详细介绍了项目开发的前期准备、初始化步骤、功能测试等内容,帮助开发者快速上手使用。

🚀 快速开始

前期准备

使用Anaconda提供Python虚拟环境,PyCharm提供集成开发环境。 具体参考视频: 【大模型应用开发-入门系列】03 集成开发环境搭建-开发前准备工作 YouTube链接 Bilibili链接

项目初始化

安装依赖

运行以下命令安装所需依赖:

pip install -r requirements.txt

配置文件

创建并配置以下文件:

  • config.json
  • secrets.py

启动服务

启动地图服务和MCP服务。

✨ 主要特性

地图服务功能接口

地理编码服务

示例:
输入:118.79815,32.01112
输出:江苏省苏州市姑苏区

地标查询服务

输入:夫子庙
输出:{
    "name": "夫子庙",
    "location": {
        "lng": "xxx",
        "lat": "xxx"
    }
}

IP定位服务

输入:112.10.22.229
输出:{
    "province": "江苏省",
    "city": "南京市"
}

天气查询服务

输入:上海天气
输出:当前上海天气情况

路径规划服务

  • 骑行路径规划
输入:从苏州的虎丘区到相城区,选择骑行方式
输出:详细骑行路线
  • 步行路径规划
输入:从苏州的虎丘区到相城区,选择步行方式
输出:详细步行路线
  • 驾车路径规划
输入:从苏州的虎丘区到相城区,选择驾车方式
输出:详细驾车路线
  • 公共交通路径规划
输入:从苏州的虎丘区到相城区,选择公共交通方式
输出:详细公交/地铁路线

距离测量服务

输入:从苏州的虎丘区到相城区,选择驾车方式
输出:距离数据

地标搜索服务

  • 加油站搜索
输入:苏州市虎丘区中石化加油站
输出:相关加油站信息列表
  • POI详情查询
输入:POI ID(如B020016GPH)
输出:详细POI信息

周边搜索服务

输入:苏州乐园,半径10公里,中石化加油站
输出:周边符合条件的加油站列表

MCP服务功能接口测试脚本

具体参考如下视频: 【大模型应用开发-入门系列】03 集成开发环境搭建-开发前准备工作 YouTube链接 Bilibili链接

MCP Client测试脚本

具体参考如下视频: 【大模型应用开发-入门系列】04 大模型LLM服务接口调用方案 YouTube链接 Bilibili链接

📦 安装指南

集成开发环境搭建

使用Anaconda提供Python虚拟环境,PyCharm提供集成开发环境。

安装依赖

运行以下命令安装所需依赖:

pip install -r requirements.txt

💻 使用示例

基础用法

以地理编码服务为例:

输入:118.79815,32.01112
输出:江苏省苏州市姑苏区

📚 详细文档

前期准备工作

集成开发环境搭建

使用Anaconda提供Python虚拟环境,PyCharm提供集成开发环境。具体参考视频: 【大模型应用开发-入门系列】03 集成开发环境搭建-开发前准备工作 YouTube链接 Bilibili链接

大模型LLM服务接口调用方案

具体参考视频: 【大模型应用开发-入门系列】04 大模型LLM服务接口调用方案 YouTube链接 Bilibili链接

项目初始化

安装依赖

运行以下命令安装所需依赖:

pip install -r requirements.txt

配置文件

创建并配置以下文件:

  • config.json
  • secrets.py

启动服务

启动地图服务和MCP服务。

功能测试

测试用例

基础功能测试
  • 地理编码测试
  • 地标查询测试
  • IP定位测试
  • 天气查询测试
路径规划测试
  • 骑行路径测试
  • 步行路径测试
  • 驾车路径测试
  • 公共交通路径测试
距离测量测试
  • 驾车距离测量测试
地标搜索测试
  • 加油站搜索测试
  • POI详情查询测试
周边搜索测试
  • 周边加油站搜索测试

🔧 技术细节

工具链

  • Python版本要求:3.8+
  • 依赖管理工具:pip
  • 代码编辑器:PyCharm
  • 虚拟环境管理:Anaconda

配置示例

{
    "api_key": "your_api_key",
    "endpoint": "https://example.com"
}
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端