Geoapify MCP Server

基本能力

产品定位

Geoapify MCP Server 主要用于地理编码和地图可视化，将地址信息转换为GPS坐标，并生成对应的地图图像。

核心功能

1. 地址转GPS坐标：通过API将地址转换为GPS坐标，用于创建GEOJSON等地理数据格式。
2. 地图图像生成：根据提供的GEOJSON文件生成地图图像，并支持在MacOS上显示。

适用场景

1. 地图服务：需要将地址信息转换为地图坐标的应用。
2. 地理数据可视化：生成地理数据的可视化地图图像。
3. 位置服务：任何需要地理编码和地图展示的场景。

工具列表

1. get_gps_coordinates：用于从API获取GPS坐标，创建GEOJSON等地理数据。
2. create_map_from_geojson：根据GEOJSON文件创建地图图像，并支持在MacOS上显示。

常见问题解答

1. 如何获取API密钥：需要从Geoapify官网获取API密钥，并设置为环境变量GEO_APIKEY。
2. 地图显示限制：目前地图图像显示功能仅支持MacOS。

使用教程

使用依赖

安装前需要获取Geoapify的API密钥，并设置为环境变量GEO_APIKEY。

安装教程

1. 配置claude_desktop_config.json文件，包含以下内容：

"MCP Map Demo": {
      "command": "uv",
      "args": [
    "--directory",
        "/PATH/TO/THIS/REPO",
        "run",
        "--with",
        "fastmcp",
        "--with",
        "requests",
        "--with",
        "folio",
        "--with",
        "selenium",
        "--with",
        "pillow",
        "fastmcp",
        "run",
        "/PATH/TO/THIS/REPO/server.py"
      ],
      "env": {
        "GEO_APIKEY": "YOURAPIKEY"
      }
    }

1. 确保所有依赖项（如fastmcp、requests、folio、selenium、pillow）已安装。

调试方式

1. 运行服务后，可以通过以下命令测试功能：
2. 获取GPS坐标： can you create a geojson of the following locations including their gps coordinates: [地址列表]
3. 生成地图图像： can you create a map from my attached geojson file?
4. 检查生成的GEOJSON文件和地图图像是否符合预期。

许可证

该项目遵循 MIT 开源许可条款。