JinDaGe - java-mcp-server MCP Details

article

README

🚀 基于Spring Boot的Java地图组件平台（Java MCP）

本平台提供了丰富的地图相关功能，如地理编码、天气查询、POI搜索等，借助Spring Boot框架，可帮助开发者快速集成地图服务。

🚀 快速开始

环境要求

JDK 17及以上
Maven 3.6及以上

获取项目

git clone [repository-url]
cd java-mcp-server

配置

在 src/main/resources/application.properties 文件中配置高德地图 API Key：

amap.key=your_amap_key_here

构建与运行

mvn clean package
java -jar target/demo-0.0.1-SNAPSHOT.jar

或直接使用 Maven 运行：

mvn spring-boot:run

服务启动后，访问 http://localhost:8080 即可。

✨ 主要特性

地理编码/逆地理编码：实现地址与经纬度的互相转换。
天气查询：可根据城市名称或adcode查询天气信息。
POI搜索：支持关键词搜索、周边搜索、POI详情查询。
路径规划：支持步行、骑行、驾车、公共交通等多种出行方式。
IP定位：根据IP地址获取位置信息。
距离测量：能计算两点间直线距离、驾车距离或步行距离。

📚 详细文档

技术栈

| 属性 | 详情 | |------|------| | 开发语言 | Java 17 | | 框架 | Spring Boot 3.4.4 | | 数据持久化 | Spring Data JPA | | 数据库 | H2 数据库 | | JSON处理 | Jackson JSON | | API风格 | RESTful API |

API 接口说明

集成接口（/api/mcp/）

| 接口路径 | 方法 | 描述 | 参数 | |---------|------|-----|------| | /status | GET | 获取系统状态信息 | - | | /geo | GET | 地理编码（地址转坐标） | address, city(可选) | | /regeo | GET | 逆地理编码（坐标转地址） | location(格式：经度,纬度) | | /ip | GET | IP定位 | ip(可选) | | /weather | GET | 天气查询 | city | | /search | GET | POI搜索 | keywords, city(可选), types(可选) | | /around | GET | 周边搜索 | location, radius(可选), keywords(可选) | | /detail | GET | POI详情 | id | | /walking | GET | 步行路径规划 | origin, destination | | /bicycling | GET | 骑行路径规划 | origin, destination | | /driving | GET | 驾车路径规划 | origin, destination | | /transit | GET | 公共交通路径规划 | origin, destination, city, cityd(可选) | | /distance | GET | 测量距离 | origins, destination, type(可选) |

独立接口

各功能模块也提供了独立的API接口，详见：

位置服务：/api/location/
天气服务：/api/weather/
POI服务：/api/poi/
路径规划：/api/route/
IP定位：/api/ip/

开发指南

项目结构

src/main/java/com/example/demo/
├── controller/  # 控制器层
├── service/     # 服务逻辑层
├── repository/  # 数据访问层
└── model/       # 模型/实体类

扩展步骤

克隆项目：使用上述命令克隆代码仓库。
配置API Key：在application.properties文件中设置高德地图API Key。
构建项目：运行mvn clean package进行构建。
启动服务：使用mvn spring-boot:run启动应用。

📄 许可证

本项目使用MIT License，具体条款请参考LICENSE文件。

java-mcp-server