本项目是一个基于Model Context Protocol (MCP) 实现的服务器,专注于提供地理信息系统(GIS)相关的数据转换功能和地理编码服务。通过集成多种GIS处理库,它允许连接的LLM客户端访问一系列空间数据处理能力。
主要功能点
该服务器提供以下核心功能:
- 地理格式转换: 支持在常见的地理数据格式之间进行相互转换,包括:
- GeoJSON 和 Well-Known Text (WKT) 之间的转换。
- 包含坐标的CSV文件和GeoJSON之间的转换。
- GeoJSON 和 TopoJSON(一种更紧凑、保留拓扑关系的格式)之间的转换。
- GeoJSON 和 Keyhole Markup Language (KML) 之间的转换。
- 逆地理编码 (Reverse Geocoding): 将一对经纬度坐标转换为人类可读的地点名称或地址信息。
这些功能作为“工具”暴露给LLM客户端,使得LLM可以直接调用这些能力来处理用户的地理数据相关的请求。
安装步骤
由于该服务器通常与支持MCP协议的LLM客户端(如Claude Desktop)配合使用,最简单的运行方式是通过 'npx' 命令,这通常不需要提前全局安装该包。
- 确保您的系统已安装 Node.js 环境。
- 该服务器预计会通过支持MCP的LLM客户端启动。您无需手动克隆仓库或运行 'npm install'(除非您想从源代码构建)。
服务器配置
MCP客户端需要知道如何启动并连接到该服务器。您需要在客户端的配置文件中添加如下所示的配置项。请注意,不同客户端的配置路径和格式可能略有差异,以下是典型示例(以JSON格式表示):
{ "mcpServers": { "gis-dataconversion-mcp": { // 服务器的唯一名称,客户端会使用此名称识别 "command": "npx", // 启动服务器的命令 "args": [ // 命令的参数列表 "-y", // npx 参数,表示自动同意安装包 "@ronantakizawa/gis-dataconversion-mcp" // 要运行的 npm 包名称,npx 会查找并执行其中的默认可执行文件 ] } } }
将此配置添加到您的MCP客户端配置文件的 'mcpServers' 部分。客户端启动时会读取此配置,并在需要时通过标准输入/输出(Stdio)通道启动并与服务器通信。
基本使用方法
用户通常通过与支持MCP的LLM客户端交互来间接使用此服务器。
- 确保您已按照上述步骤配置了MCP客户端,并且该客户端已成功识别并连接到“gis-dataconversion-mcp”服务器。
- 在与LLM的对话中,提出需要进行地理数据转换或逆地理编码的任务。
- 例如:“请将这段WKT数据转换为GeoJSON格式:'POLYGON((-118.2437 34.0522, ...))'”
- 例如:“请帮我查找坐标 (34.0522, -118.2437) 对应的地点信息。”
- 例如:“这是一段包含经纬度列的CSV数据,请将其转换为GeoJSON。”
- LLM会识别出您的请求需要调用外部工具(即本MCP服务器提供的工具),然后通过MCP协议向服务器发送相应的 'call_tool' 请求,并附带必要的参数(如WKT字符串、坐标、CSV数据等)。
- MCP服务器执行转换或查询操作,并将结果(通常是转换后的数据字符串或位置信息JSON字符串)通过MCP协议返回给LLM。
- LLM接收到服务器返回的结果后,会将其格式化并在对话中呈现给用户。
用户无需直接与服务器程序交互,所有操作都通过与LLM的自然语言对话完成。
信息
分类
AI与计算