KSX-AI 腾讯地图集成项目

项目概述

本项目直接集成腾讯地图WebService API，提供地图服务功能，无需使用MCP（Model Context Protocol）。

架构说明

当前架构

前端 (Vue.js) 
    ↓ HTTP请求
后端 (Spring Boot)
    ↓ 直接调用
腾讯地图WebService API

核心组件

• McpService: 腾讯地图API服务封装
• McpController: REST API接口
• TencentMapSignatureUtils: 签名计算工具
• 前端测试页面: 功能测试界面

功能特性

1. 智能地址处理

• 地址标准化: 自动处理常见地名（天安门→天安门广场）
• 多格式支持: 支持城市名称、adcode、地址名称
• 智能匹配: 自动移除省份前缀、城市后缀

2. 地图服务功能

• 天气查询: 实时天气和天气预报
• 路线规划: 自驾、步行、公交路线
• 地点搜索: POI搜索和详情查询
• 地理编码: 地址转坐标

3. 错误处理和调试

• 详细日志: 完整的API调用日志
• 备用方案: 地理编码失败时自动使用地点搜索
• 调试工具: 前端调试界面

技术优势

相比MCP的优势

1. 简单直接: 无需额外的MCP服务器
2. 性能更好: 减少中间层，响应更快
3. 维护简单: 代码结构清晰，易于维护
4. 成本更低: 减少服务器资源消耗

适用场景

• 需要地图服务的Web应用
• AI助手的地图功能集成
• 移动应用的后端服务
• 企业内部的地址服务

配置说明

环境变量

# 腾讯地图API配置
export MCP_QQ_KEY=your_tencent_map_api_key
export MCP_QQ_SECRET_KEY=your_secret_key

配置文件

mcp:
  qq:
    key: ${MCP_QQ_KEY}
    secret-key: ${MCP_QQ_SECRET_KEY}
    base-url: https://apis.map.qq.com

API接口

天气查询

GET /api/mcp/weather?adcode=北京

路线规划

GET /api/mcp/route?origin=北京站&destination=天安门&mode=driving

地点搜索

GET /api/mcp/search?keyword=景点&city=北京

部署说明

1. 启动后端

mvn spring-boot:run

2. 启动前端

cd ksxai
npm run serve

3. 访问测试页面

http://localhost:8080/mcp-test

扩展建议

1. 缓存优化

• 添加Redis缓存常用地址的坐标
• 缓存天气数据，减少API调用

2. 监控告警

• 添加API调用监控
• 设置错误率告警

3. 负载均衡

• 支持多个API Key轮询
• 添加请求限流

总结

当前架构已经很好地满足了地图服务的需求，无需引入MCP的复杂性。直接使用腾讯地图WebService API是最佳选择。