AI导哈

地图服务器

MCP地图服务器是一个基于OpenAI代理SDK和模型上下文协议的交互式地图服务，提供地理编码、路径规划和兴趣点搜索等功能，适用于需要地图服务的开发者和应用场景。

  • by Safaa-Salman
  • Jupyter Notebook
  • 本地部署
  • 更新于
在 GitHub 查看 Safaa-Salman/MCP_Map_Servers

使用说明

MCP地图服务器-Colab笔记本电脑

概述

使用OpenAI代理SDK和模型上下文协议完成MCP地图服务器的交互式实现。完全在Google Colab中运行，无需本地安装。

快速开始

  1. 上传 MCP_Map_Servers_Colab.ipynb 转到谷歌云端硬盘
  2. 使用Google Colab打开
  3. 将OpenAI API密钥添加到Colab机密(🔑 icon → OPENAI_API_KEY)
  4. 运行所有单元格： 运行时→ 全部运行
  5. 使用底部的Gradio界面

建筑

模型上下文协议（MCP）

MCP允许OpenAI代理发现和调用地图服务器公开的自定义工具。每个工具都注册了一个JSON模式，定义了它的目的和参数，使代理能够智能地编排多个操作。

地图服务器

🚗 城市导航服务器 使用OpenStreetMap数据处理地理编码和路由操作。

工具：

  • forward_geocode(address) -将街道地址转换为纬度/经度坐标
  • reverse_geocode(latitude, longitude) -将坐标转换为人类可读的地址
  • route(origin, destination, mode) -计算具有转弯方向（驾驶/步行/骑自行车）的路线

API： 提名（地理编码）、OSRM（路线）

📍 地点探索者服务器 提供POI搜索和位置发现功能。

工具：

  • search_poi(category, city) -按类别查找城市内的地点（例如柏林的博物馆）
  • search_nearby(latitude, longitude, category, radius_km) -发现特定坐标附近的位置
  • suggest_places(query) -模糊搜索地名和地标

API： 天桥（POI数据）、Photon（地点搜索）

🤖 MapAssistant（OpenAI代理）

使用带有函数调用的GPT-4o-mini协调两台服务器。自动链接2-5个工具来回答复杂的问题，比如“在埃菲尔铁塔附近找咖啡馆，给我从卢浮宫的方向。”

🛠️ 工具和API

6个工具（每台服务器3个）：

  • forward_geocode, reverse_geocode, route
  • search_poi, search_nearby, suggest_places

4个API：

  • 提名（地理编码）、OSRM（路线）
  • 天桥（POI数据）、Photon（搜索）

💡 用法

查询示例：

"What are the coordinates of the Eiffel Tower?"
"Find cafes near the Eiffel Tower and give me directions from the Louvre"
"What's at coordinates 48.8584, 2.2945, find restaurants within 1km"

相关 MCP