mcp-server-proj
If you are the rightful owner of mcp-server-proj and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A Model Context Protocol (MCP) server for coordinate system transformations and map projections.
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
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 systemset_target_crs(crs: str): Set target coordinate systeminitialize_transformer(): Initialize the transformertransform_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 ()
Contributing
Issues and Pull Requests are welcome!
