MCP-OSM: OpenStreetMap Integration for MCP

基本能力

产品定位

MCP-OSM是一个地图服务集成工具，旨在为MCP系统提供OpenStreetMap地图数据的查询和可视化功能。

核心功能

• 基于Leaflet和OpenStreetMap的Web地图查看器
• 通过Server-Sent Events (SSE)实现服务器到客户端的通信
• 地图控制工具（添加标记、多边形、设置视图、获取视图等）
• 针对OpenStreetMap数据的PostgreSQL/PostGIS查询接口

适用场景

• 需要在地理信息系统中集成OpenStreetMap数据的应用
• 需要可视化地理数据的项目
• 需要执行复杂地理查询的应用

工具列表

• get_map_view: 获取当前地图视图
• set_map_view: 设置地图视图到特定坐标或边界
• set_map_title: 设置地图右下角显示的标题
• add_map_marker: 在特定坐标添加标记
• add_map_line: 添加由一组坐标定义的线
• add_map_polygon: 添加由一组坐标定义的多边形
• query_osm_postgres: 对OpenStreetMap数据库执行SQL查询

常见问题解答

暂无提供

使用教程

使用依赖

需要安装以下依赖： - PostgreSQL数据库 - PostGIS扩展 - Python环境 - psycopg2库

安装教程

1. 确保已安装Python和PostgreSQL
2. 安装必要的Python包：

pip install mcp[cli] psycopg2

1. 克隆项目仓库：

git clone https://github.com/your-repo/mcp-osm.git
cd mcp-osm

1. 创建并配置.env文件，设置必要的环境变量
2. 使用以下命令启动服务：

uv run --env-file .env --with mcp[cli] --with psycopg2 --with-editable /path/to/mcp-osm --directory /path/to/mcp-osm mcp run mcp.py

调试方式

1. 服务启动后，访问http://localhost:8889/查看地图界面
2. 可以使用MCP工具进行交互测试
3. 检查日志输出以排查问题

许可证

None