1、接口规范

1.1 地图服务功能接口

1.1.1 地理编码服务

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

1.1.2 地标查询服务

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

1.1.3 IP定位服务

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

1.1.4 天气查询服务

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

1.1.5 路径规划服务

• 骑行路径规划

输入：从苏州的虎丘区到相城区，选择骑行方式
输出：详细骑行路线

• 步行路径规划

输入：从苏州的虎丘区到相城区，选择步行方式
输出：详细步行路线

• 驾车路径规划

输入：从苏州的虎丘区到相城区，选择驾车方式
输出：详细驾车路线

• 公共交通路径规划

输入：从苏州的虎丘区到相城区，选择公共交通方式
输出：详细公交/地铁路线

1.1.6 距离测量服务

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

1.1.7 地标搜索服务

• 加油站搜索

输入：苏州市虎丘区中石化加油站
输出：相关加油站信息列表

• POI详情查询

输入：POI ID（如B020016GPH）
输出：详细POI信息

1.1.8 周边搜索服务

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

1.2 MCP服务功能接口测试脚本

具体参考如下视频： 【大模型应用开发-入门系列】03 集成开发环境搭建-开发前准备工作 https://youtu.be/KyfGduq5d7w https://www.bilibili.com/video/BV1nvdpYCE33/

1.3 MCP Client测试脚本

具体参考如下视频： 【大模型应用开发-入门系列】04 大模型LLM服务接口调用方案 https://youtu.be/mTrgVllUl7Y https://www.bilibili.com/video/BV1BvduYKE75/

2、前期准备工作

2.1 集成开发环境搭建

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

具体参考视频： 【大模型应用开发-入门系列】03 集成开发环境搭建-开发前准备工作 https://youtu.be/KyfGduq5d7w https://www.bilibili.com/video/BV1nvdpYCE33/

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

具体参考视频： 【大模型应用开发-入门系列】04 大模型LLM服务接口调用方案 https://youtu.be/mTrgVllUl7Y https://www.bilibili.com/video/BV1BvduYKE75/

3、项目初始化

3.1 安装依赖

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

pip install -r requirements.txt

3.2 配置文件

创建并配置以下文件：

• config.json
• secrets.py

3.3 启动服务

启动地图服务和MCP服务。

4、功能测试

4.1 测试用例

4.1.1 基础功能测试

• 地理编码测试
• 地标查询测试
• IP定位测试
• 天气查询测试

4.1.2 路径规划测试

• 骑行路径测试
• 步行路径测试
• 驾车路径测试
• 公共交通路径测试

4.1.3 距离测量测试

• 驾车距离测量测试

4.1.4 地标搜索测试

• 加油站搜索测试
• POI详情查询测试

4.1.5 周边搜索测试

• 周边加油站搜索测试

5、附录

5.1 工具链

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

5.2 配置示例

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

以上为项目文档的完整翻译内容。