# Mcp Server Proj

> MCP Server PROJ (cartographic projections and coordinate transformations )

- **Type:** MCP server
- **Install:** `agentstack add mcp-radial-hks-mcp-server-proj`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [radial-hks](https://agentstack.voostack.com/s/radial-hks)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [radial-hks](https://github.com/radial-hks)
- **Source:** https://github.com/radial-hks/mcp-server-proj

## Install

```sh
agentstack add mcp-radial-hks-mcp-server-proj
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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

```bash
pip install mcp-server-proj
```

## Usage

### Server Mode

```bash
mcp-server-proj
```

### Library Mode

```python
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
  ```json
  {
    "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](https://github.com/modelcontextprotocol/inspector):

```bash
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!

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [radial-hks](https://github.com/radial-hks)
- **Source:** [radial-hks/mcp-server-proj](https://github.com/radial-hks/mcp-server-proj)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-radial-hks-mcp-server-proj
- Seller: https://agentstack.voostack.com/s/radial-hks
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
