https://github.com/javaaidev/amap-mcp-server
Amap MCP server (高德地图 MCP 服务器)
https://github.com/javaaidev/amap-mcp-server
amap kotlin mcp mcp-server
Last synced: 28 days ago
JSON representation
Amap MCP server (高德地图 MCP 服务器)
- Host: GitHub
- URL: https://github.com/javaaidev/amap-mcp-server
- Owner: JavaAIDev
- License: apache-2.0
- Created: 2025-06-29T06:49:47.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-11-23T00:21:18.000Z (8 months ago)
- Last Synced: 2025-11-23T02:22:27.215Z (8 months ago)
- Topics: amap, kotlin, mcp, mcp-server
- Language: Kotlin
- Homepage:
- Size: 121 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Amap MCP Server （高德地图 MCP 服务器）
MCP Server for [Amap](https://lbs.amap.com/)
使用 Kotlin 开发的高德地图 MCP 服务器
## Tools available
- [IP定位](https://lbs.amap.com/api/webservice/guide/api/ipconfig)
- [地理/逆地理编码](https://lbs.amap.com/api/webservice/guide/api/georegeo)
- [静态地图](https://lbs.amap.com/api/webservice/guide/api/staticmaps)
- [天气查询](https://lbs.amap.com/api/webservice/guide/api-advanced/weatherinfo)
- [行政区域查询](https://lbs.amap.com/api/webservice/guide/api/district)
- [搜索POI 2.0](https://lbs.amap.com/api/webservice/guide/api-advanced/newpoisearch)
- [路径规划 2.0](https://lbs.amap.com/api/webservice/guide/api/newroute)
- [坐标转换](https://lbs.amap.com/api/webservice/guide/api/convert)
- [输入提示](https://lbs.amap.com/api/webservice/guide/api-advanced/inputtips)
## How to use
Go to [releases](https://github.com/JavaAIDev/amap-mcp-server/releases) page and download latest releases:
- JAR file, requires Java 11 to run
- Native executable files on Windows, macOS and Linux.
Or use the [container image](https://github.com/JavaAIDev/amap-mcp-server/pkgs/container/amap-mcp-server).
Amap API key is required. This key must be set as the environment variable `AMAP_API_KEY`.
Below is the config to start the server using `java`.
```json
{
"mcpServers": {
"amap": {
"command": "java",
"args": [
"-jar",
"amap-mcp-server.jar"
],
"env": {
"AMAP_API_KEY": "YOUR_AMAP_API_KEY"
}
}
}
}
```
It's better to use [jbang](https://www.jbang.dev/) to run a JAR file.
```json
{
"mcpServers": {
"amap": {
"command": "jbang",
"args": [
"https://github.com/JavaAIDev/amap-mcp-server/releases/download/v0.9.0/amap-mcp-server.jar"
],
"env": {
"AMAP_API_KEY": "YOUR_AMAP_API_KEY"
}
}
}
}
```
The config below starts the server using a container image.
```json
{
"mcpServers": {
"amap": {
"command": "docker",
"args": [
"run",
"-i",
"-e",
"AMAP_API_KEY=YOUR_AMAP_API_KEY",
"ghcr.io/javaaidev/amap-mcp-server:0.9.0"
]
}
}
}
```