Java MCP Server

🚀 Java Map Component Platform (Java MCP) Based on Spring Boot

Java MCP is a powerful platform that offers various map - related services such as geocoding, weather query, POI search, etc.

✨ Features

• Geocoding/Reverse Geocoding: Convert addresses to coordinates and vice versa.
• Weather Query: Retrieve weather information by city name or adcode.
• POI Search: Support keyword search, nearby search, and POI detail query.
• Route Planning: Provide multiple travel modes including walking, cycling, driving, and public transportation.
• IP Location: Obtain location information based on IP addresses.
• Distance Measurement: Calculate the straight - line distance, driving distance, or walking distance between two points.

🔧 Technical Details

• Java 17
• Spring Boot 3.4.4
• Spring Data JPA
• H2 Database
• Jackson JSON
• RESTful API

🚀 Quick Start

Environment Requirements

• JDK 17 or higher
• Maven 3.6 or higher

Get the Project

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

Configuration

Configure the Amap API Key in the src/main/resources/application.properties file:

amap.key=your_amap_key_here

Build and Run

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

Or run directly using Maven:

mvn spring-boot:run

After the service starts, you can access http://localhost:8080.

📚 Documentation

Integrated API Interfaces (/api/mcp/)

Independent API Interfaces

Each functional module also provides independent API interfaces. For details, see:

• Location Service: /api/location/
• Weather Service: /api/weather/
• POI Service: /api/poi/
• Route Planning: /api/route/
• IP Location: /api/ip/

💻 Usage Examples

Project Structure

src/main/java/com/example/demo/
├── controller/  # Controller layer
├── service/     # Service logic layer
├── repository/  # Data access layer
└── model/       # Model/Entity classes

Extension Steps

1. Clone the project: Use the above commands to clone the code repository.
2. Configure the API Key: Set the Amap API Key in the application.properties file.
3. Build the project: Run mvn clean package for building.
4. Start the service: Use mvn spring-boot:run to start the application.

📄 License

This project is licensed under the MIT License. Please refer to the LICENSE file for specific terms.