项目简介
MCP 坐标转换服务器是一个遵循 Model Context Protocol (MCP) 标准的应用后端。它专注于提供专业的地理坐标系统转换服务,允许与其连接的 MCP 客户端(如大型语言模型应用)方便地执行坐标转换任务。
主要功能点
- 支持多种坐标系统格式: 能够识别和处理包括 EPSG 代码(如 EPSG:4326)、WKT (Well-Known Text) 格式字符串和 Proj 字符串格式在内的多种坐标系表示方法。
- 高性能转换: 利用成熟的地理信息处理库进行精确高效的坐标转换。
- 工具化服务: 将坐标转换能力封装为可由 MCP 客户端调用的工具,简化集成过程。提供了例如“转换坐标”和“列出支持的坐标系统”等工具。
安装步骤
要安装 MCP 坐标转换服务器,您需要 Python 3.12 或更高版本以及 'pip' 工具。
-
打开终端或命令提示符。
-
执行以下命令进行安装:
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 客户端启动连接后,客户端即可通过调用服务器提供的工具来使用其功能。
-
列出支持的坐标系统: 客户端可以调用 'list-supported-crs' 工具来获取服务器支持的坐标系统格式列表及其示例。
- 工具名: 'list-supported-crs'
- 输入参数: 无
- 输出: 一段包含支持格式(EPSG, WKT, Proj)及其示例的文本描述。
-
执行坐标转换: 客户端可以调用 '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与计算