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"