项目简介

MCP 坐标转换服务器是一个遵循 Model Context Protocol (MCP) 标准的应用后端。它专注于提供专业的地理坐标系统转换服务,允许与其连接的 MCP 客户端(如大型语言模型应用)方便地执行坐标转换任务。

主要功能点

  • 支持多种坐标系统格式: 能够识别和处理包括 EPSG 代码(如 EPSG:4326)、WKT (Well-Known Text) 格式字符串和 Proj 字符串格式在内的多种坐标系表示方法。
  • 高性能转换: 利用成熟的地理信息处理库进行精确高效的坐标转换。
  • 工具化服务: 将坐标转换能力封装为可由 MCP 客户端调用的工具,简化集成过程。提供了例如“转换坐标”和“列出支持的坐标系统”等工具。

安装步骤

要安装 MCP 坐标转换服务器,您需要 Python 3.12 或更高版本以及 'pip' 工具。

  1. 打开终端或命令提示符。

  2. 执行以下命令进行安装:

    pip install mcp-server-proj

这将安装服务器及其所有必要的依赖项。

服务器配置

本服务器设计为由 MCP 客户端通过标准输入/输出 (Stdio) 方式启动和通信。对于 MCP 客户端而言,连接到此服务器通常需要以下配置信息:

  • 服务器名称 (name): 'mcp-coordinate-transform'
  • 启动命令 (command): 运行服务器的可执行文件路径或命令,在本例中是 'mcp-server-proj'。通常客户端只需要指定命令名,系统会在 PATH 环境变量中查找。

客户端配置示例 (JSON 格式,此处仅为说明结构,请勿直接复制到终端运行):

{
  "name": "mcp-coordinate-transform",
  "command": ["mcp-server-proj"]
  // 其他可能的客户端配置选项,如参数args等,本服务器当前无需特定启动参数
}

注意: 实际配置方式取决于您的 MCP 客户端实现。上述 JSON 仅说明客户端需要知道的服务器识别名称和启动方式。

基本使用方法

服务器安装并由 MCP 客户端启动连接后,客户端即可通过调用服务器提供的工具来使用其功能。

  1. 列出支持的坐标系统: 客户端可以调用 'list-supported-crs' 工具来获取服务器支持的坐标系统格式列表及其示例。

    • 工具名: 'list-supported-crs'
    • 输入参数:
    • 输出: 一段包含支持格式(EPSG, WKT, Proj)及其示例的文本描述。
  2. 执行坐标转换: 客户端可以调用 'transform-coordinates' 工具来进行实际的坐标转换。

    • 工具名: 'transform-coordinates'
    • 输入参数 (JSON 对象):
      • 'source_crs' (字符串): 源坐标系统的定义 (EPSG 代码, WKT 或 Proj 字符串)。
      • 'target_crs' (字符串): 目标坐标系统的定义 (EPSG 代码, WKT 或 Proj 字符串)。
      • 'coordinates' (对象数组): 要转换的坐标点列表。每个对象包含 'x' (横坐标) 和 'y' (纵坐标) 两个浮点数。 示例输入参数结构:
        {
          "source_crs": "EPSG:4326",
          "target_crs": "EPSG:3857",
          "coordinates": [
            {"x": 116.391275, "y": 39.907486},
            {"x": 120.15507, "y": 30.27408}
          ]
        }
    • 输出: 一段文本,包含每个输入坐标点及其转换后的结果坐标,或转换失败的错误信息。结果坐标通常会格式化为包含指定小数位的字符串。

具体的工具调用和结果解析逻辑由 MCP 客户端负责实现。

信息

分类

AI与计算