About Proj
Proj is an MCP server published by radial-hks in the Productivity category: mCP Server PROJ (cartographic projections and coordinate transformations ).
The repository has 2 stars and 0 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/radial-hks/mcp-server-projThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Proj
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository yesterday. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
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 (radialjiajie@gmail.com)
Contributing
Issues and Pull Requests are welcome!
README fetched from the repository yesterday. The original is authoritative.