Geo MCP Server

🚀 @zealgeo/mcp-geo-server

A geoprocessing tool server based on the Model Context Protocol (MCP), offering spatial analysis functions such as coordinate system conversion, distance calculation, and area calculation.

🚀 Quick Start

This section provides a quick overview of how to get started with the @zealgeo/mcp-geo-server.

📦 Installation

To install the @zealgeo/mcp-geo-server, use the following configuration in your JSON file:

"geo-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@zealgeo/mcp-geo-server"
      ]
    }

✨ Features

Coordinate System Conversion

The server supports conversion between the following coordinate systems:

• BD09 (Baidu Coordinate System)
• GCJ02 (Mars Coordinate System)
• WGS84 (GPS Coordinate System)
• Web Mercator (Web Mercator Projection)

Supported conversion methods include:

• Conversion between BD09 and GCJ02
• Conversion between WGS84 and GCJ02
• Conversion between BD09 and WGS84
• Conversion between Web Mercator and longitude/latitude

Spatial Calculation

The server also supports the following spatial calculations:

• Calculate the distance of a polyline (supports meters and kilometers as units)
• Calculate the area of a polygon (supports square meters, square kilometers, and hectares as units)
• Accept input in multiple coordinate systems (WGS84, GCJ02, BD09)

📚 Documentation

MCP Tools

mcp_geo_convert

This tool is used for coordinate system conversion. It supports conversion between BD09, GCJ02, WGS84, and Web Mercator.

Parameters:

• method: Conversion method
  • BD09toGCJ02: Convert from Baidu Coordinate System to Mars Coordinate System
  • GCJ02toBD09: Convert from Mars Coordinate System to Baidu Coordinate System
  • WGS84toGCJ02: Convert from WGS84 to Mars Coordinate System
  • GCJ02toWGS84: Convert from Mars Coordinate System to WGS84
  • BD09toWGS84: Convert from Baidu Coordinate System to WGS84
  • WGS84toBD09: Convert from WGS84 to Baidu Coordinate System
  • WebMercatortoLngLat: Convert from Web Mercator to longitude/latitude
  • LngLattoWebMercator: Convert from longitude/latitude to Web Mercator
• longitude: Longitude value
• latitude: Latitude value

mcp_geo_calculate_distance

This tool calculates the distance of a polyline. It uses the Web Mercator projection for planar distance calculation.

Parameters:

• coordinates: An array of polyline coordinate points [[lon1,lat1], [lon2,lat2], ...]
• unit: Length unit (meters [default], kilometers)
• coordType: Input coordinate type (WGS84 [default], GCJ02, BD09)

mcp_geo_calculate_area

This tool calculates the area of a polygon. It uses the Web Mercator projection for planar area calculation.

Parameters:

• coordinates: An array of polygon coordinate points [[lon1,lat1], [lon2,lat2], ...]
• unit: Area unit (square_meters [default], square_kilometers, hectares)
• coordType: Input coordinate type (WGS84 [default], GCJ02, BD09)

Coordinate System Explanation

BD09 (Baidu Coordinate System)

This is the coordinate system used by Baidu Maps, which is encrypted based on the GCJ02 coordinate system.

GCJ02 (Mars Coordinate System)

This is a coordinate system developed by the Chinese National Surveying and Mapping Bureau, which is an encrypted version of the WGS84 coordinate system.

WGS84

This is the original coordinate system of GPS and is widely used in the current GPS global satellite positioning system.

Web Mercator

This is a projected coordinate system used in web maps, which converts spherical coordinates to planar coordinates. It can provide more accurate results when used for distance and area calculations.

⚠️ Important Note

• The accuracy of coordinate conversion is related to the quality of the original data.
• For coordinates outside mainland China, the conversion between WGS84 and GCJ02 will directly return the original coordinates.
• Web Mercator coordinates are usually in meters.
• The distance and area calculations use the planar calculation method after Web Mercator projection, which is suitable for small and medium-scale calculations.
• For extremely long distances or large areas spanning continents, it is recommended to use the spherical calculation method.
• The polygon area calculation does not require manual closure, and the program will automatically handle it.