Skip to main content
Glama
MCP Server PROJ

MCP Server PROJ

by radial-hks

MCP Server PROJ

A Model Context Protocol (MCP) server for coordinate system transformations and map projections.

Features

  • Multiple coordinate system format support:

    • EPSG codes

    • WKT (Well-Known Text)

    • Proj string format

  • Batch coordinate transformation

  • Simple and intuitive API

  • Dual-mode operation: server or library

Related MCP server: GeoSpatial MCP Server

Installation

pip install mcp-server-proj

Usage

Server Mode

mcp-server-proj

Library Mode

from mcp_server_proj import CoordinateTransformer

# Create transformer instance
transformer = CoordinateTransformer()

# Set source and target coordinate systems
transformer.set_source_crs("EPSG:4326")  # WGS84
transformer.set_target_crs("EPSG:3857")  # Web Mercator

# Initialize transformer
transformer.initialize_transformer()

# Transform coordinates
x, y = transformer.transform_point(116.3, 39.9)
print(f"Transformed coordinates: ({x}, {y})")

API Documentation

CoordinateTransformer

The main coordinate transformation class provides the following methods:

  • set_source_crs(crs: str): Set source coordinate system

  • set_target_crs(crs: str): Set target coordinate system

  • initialize_transformer(): Initialize the transformer

  • transform_point(x: float, y: float) -> tuple[float, float]: Transform a single point

Server

The MCP protocol server provides two tools:

  • transform-coordinates: Transform coordinates between different systems

    {
      "source_crs": "EPSG:4326",
      "target_crs": "EPSG:3857",
      "coordinates": [
        {"x": 116.3, "y": 39.9}
      ]
    }
  • list-supported-crs: List all supported coordinate systems

Supported Coordinate Systems

1. EPSG Codes

Standard identifiers for coordinate reference systems:

  • EPSG:4326 - WGS84 Geographic

  • EPSG:3857 - Web Mercator

  • And many more...

2. WKT Format

Example of a geographic coordinate system:

GEOGCS["WGS 84",
  DATUM["WGS_1984",
    SPHEROID["WGS 84",6378137,298.257223563]],
  PRIMEM["Greenwich",0],
  UNIT["degree",0.0174532925199433]]

3. Proj Format

Example of WGS84:

+proj=longlat +datum=WGS84 +no_defs +type=crs

Development

Debugging

For the best debugging experience, use the MCP Inspector:

npx @modelcontextprotocol/inspector mcp-server-proj

Dependencies

  • Python >= 3.12

  • mcp >= 1.3.0

  • pyproj >= 3.0.0

License

MIT

Author

radial-hks (radialjiajie@gmail.com)

Contributing

Issues and Pull Requests are welcome!

Available Tools

2 tools
list-supported-crsB

列出所有支持的坐标系统

Inputs: no named parameters.

transform-coordinatesA

在不同坐标系统之间转换坐标,支持EPSG、WKT和Proj格式的坐标系统

Inputs: source_crs (required), target_crs (required), coordinates (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have clearly distinct purposes: one transforms coordinates between systems, the other lists supported coordinate systems. There is no overlap or ambiguity between them.

    Naming Consistency5/5

    Both tool names follow a consistent verb-noun pattern with hyphenated lowercase (transform-coordinates, list-supported-crs), making the naming predictable and easy to understand.

    Tool Count3/5

    With only two tools, the server feels thin for a coordinate transformation service. While they cover a minimal workflow, the count is borderline and could be expanded with additional useful operations.

    Completeness4/5

    The core workflow is covered: users can list supported CRS and transform coordinates between them. Minor gaps exist, such as retrieving detailed CRS metadata or more advanced PROJ operations, but the basics are functional.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      A Model Context Protocol server that enables efficient discovery and retrieval of NASA Earth Data for geospatial analysis.
      27
      BSD 3-Clause
    • A
      license
      A
      quality
      D
      maintenance
      A Model Context Protocol (MCP) based geographic processing server that provides spatial analysis functions including coordinate system conversions, distance calculations, and area calculations.
      3
      40 npm
      3
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A Model Context Protocol server that connects Large Language Models to the GeoServer REST API, enabling AI assistants to query and manipulate geospatial data through natural language.
      9
      97
      MIT
    • A
      license
      C
      quality
      D
      maintenance
      A Model Context Protocol server that connects LLMs to GIS operations, enabling AI assistants to perform accurate geospatial analysis including geometric operations, coordinate transformations, and spatial measurements.
      87
      205
      MIT