mcp-server-proj MCP server

MCP Server PROJ

用于坐标系转换和地图投影的 Model Context Protocol（MCP）服务。

功能

• 支持多种坐标系格式：
  • EPSG 代码
  • WKT（Well-Known Text）
  • Proj 字符串格式
• 批量坐标转换
• 简洁直观的 API
• 双模式运行：服务或库

安装

pip install mcp-server-proj

用法

服务模式

mcp-server-proj

库模式

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 文档

CoordinateTransformer

主要的坐标转换类提供以下方法：

• set_source_crs(crs: str)：设置源坐标系
• set_target_crs(crs: str)：设置目标坐标系
• initialize_transformer()：初始化转换器
• transform_point(x: float, y: float) -> tuple[float, float]：转换单个点

服务

MCP 协议服务提供两个工具：

• transform-coordinates：在不同坐标系之间转换坐标

  {
    "source_crs": "EPSG:4326",
    "target_crs": "EPSG:3857",
    "coordinates": [
      {"x": 116.3, "y": 39.9}
    ]
  }
  

• list-supported-crs：列出所有支持的坐标系

支持的坐标系

1. EPSG 代码

坐标参考系的标准标识符：

• EPSG:4326 - WGS84 地理坐标系
• EPSG:3857 - Web Mercator
• 以及更多……

2. WKT 格式

地理坐标系示例：

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

3. Proj 格式

WGS84 示例：

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

开发

调试

如需获得最佳调试体验，请使用 MCP Inspector：

npx @modelcontextprotocol/inspector mcp-server-proj

依赖项

• Python >= 3.12
• mcp >= 1.3.0
• pyproj >= 3.0.0

许可证

MIT

作者

radial-hks ([email protected])

贡献

欢迎提交 Issues 和 Pull Requests！