mcp_dl

基于 MCP（SSE 协议）的地理工具服务。

将三个地理计算能力暴露为 MCP 工具，供阿里百炼等支持 MCP 的平台按需调用。支持本地运行，也适配 ModelScope 创空间部署。

功能

• 地点聚类分组：对多个地点按直线距离阈值做传递闭包聚类（单链接连通分量）。
• 两地直线距离：基于经纬度用 Haversine 公式计算球面距离（公里）。
• 多地方向排序：按 北→南 / 南→北 / 东→西 / 西→东 线性排序，并给出相邻间隔距离与累计距离。

文件说明

文件	作用
geo_tools.py	纯算法模块（仅依赖 math + pydantic，无网络/MCP 依赖）
geo_mcp_server.py	MCP 地理工具服务（SSE），把算法包装为 MCP 工具；build_app() 返回带鉴权的 ASGI app
app.py	ModelScope 创空间默认入口，复用 build_app() 用 uvicorn 监听 0.0.0.0:7860
config.py	配置，所有配置项支持同名环境变量覆盖
requirements.txt	依赖清单

运行

本地启动

# 安装依赖
pip install -r requirements.txt

# 方式一：直接启动（默认 0.0.0.0:9876，SSE 端点 /sse）
python geo_mcp_server.py

# 方式二：用创空间入口启动（默认 0.0.0.0:7860，与线上环境一致）
python app.py

ModelScope 创空间部署

1. 将本仓库作为创空间代码源（创空间默认执行 app.py，并自动 pip install -r requirements.txt）。

2. 创空间把容器内 0.0.0.0:7860 反向代理为公网域名，部署后 MCP SSE 端点对外即：

   https://<创空间域名>/sse
   

3. 若设置了 MCP_TOKEN，调用方请求需带 Authorization: Bearer <MCP_TOKEN>。

环境变量

变量	说明	默认值
MCP_SERVER_LABEL	MCP 服务标识	geo-mcp-service
MCP_SERVER_DESC	MCP 服务描述	地理工具：聚类分组、距离计算、方向排序
MCP_SERVER_URL	对外暴露的 SSE 端点（注册到平台时填）	http://localhost:9876/sse
MCP_TOKEN	MCP 鉴权 token，两端需一致；留空则不校验	空
GEO_MCP_HOST / GEO_MCP_PORT	geo_mcp_server.py 直接启动时的监听地址 / 端口	0.0.0.0 / 9876
PORT	创空间入口 app.py 的监听端口（创空间约定）	7860

敏感信息请通过环境变量注入，不要硬编码。