SL Transit MCP服务器
一个模型上下文协议（MCP）服务器，提供斯德哥尔摩本地交通（SL）的行程规划和实时信息，用于日常通勤监控和行程规划。
特点/特性
- 基于坐标的运算使用纬度/经度坐标查找站点并规划行程
- 实时出发信息获取附近站点的即将发车信息
- 行程规划计算任意两点之间的路线
- 交通监控检查当前的中断情况和服务警报
- 已保存的路线监控预配置的通勤路线
- 委员会整合专为AI代理工作流程设计
安装
- 安装依赖项：
pip install -e .- 配置已保存的路由（可选）：
复制 sl_transit_config.json 并根据您的位置进行自定义设置。
API 访问
无需API密钥！ SL API 可免费使用，无需认证。只需安装并运行服务器即可。
使用方法
MCP 工具
find_nearby_stops
查找给定坐标范围内所有的中转站。
await find_nearby_stops(
lat=59.3293,
lon=18.0686,
radius_meters=500,
transport_modes=["metro", "bus"]
)get_departures_near_location
获取坐标附近所有站点的即将发车信息。
await get_departures_near_location(
lat=59.3293,
lon=18.0686,
radius_meters=300,
transport_mode="metro",
time_window_minutes=30
)plan_journey_by_coordinates
规划从一个坐标点到另一个坐标点的旅程。
await plan_journey_by_coordinates(
origin_lat=59.3293,
origin_lon=18.0686,
dest_lat=59.3326,
dest_lon=18.0649,
departure_time="2024-01-15T08:30:00",
transport_modes=["metro", "bus"]
)get_deviations
获取当前的交通中断信息和服务提醒。
await get_deviations(
transport_modes=["metro"],
lines=["Red line"],
severity="high"
)check_saved_route
检查预配置路由的状态。
await check_saved_route("home_to_work")配置
服务器从（某处）加载配置 sl_transit_config.json:
{
"saved_routes": {
"home_to_work": {
"name": "Home to Work",
"origin": {
"lat": 59.3293,
"lon": 18.0686,
"label": "Home"
},
"destination": {
"lat": 59.3326,
"lon": 18.0649,
"label": "Office"
},
"typical_duration_minutes": 35,
"notify_if_delay_exceeds_minutes": 5,
"preferred_transport_modes": ["metro", "bus"]
}
},
"favorite_locations": {
"home": {
"lat": 59.3293,
"lon": 18.0686,
"label": "Home"
}
}
}委员会整合
这台服务器旨在与人工智能规划代理（即“奥利弗关怀委员会”）协同工作：
晨间计划
# Check commute before daily planning
commute_status = await check_saved_route("home_to_work")
if "delay" in commute_status:
# Add note to daily plan
# Suggest earlier departure下午提醒事项
# Help Oliver leave on time
work_to_home = await check_saved_route("work_to_home")
# Calculate when to leave
# Provide ADHD-friendly reminder会议规划
# Calculate travel time for external meetings
journey = await plan_journey_by_coordinates(
origin_lat=office_lat,
origin_lon=office_lon,
dest_lat=meeting_lat,
dest_lon=meeting_lon
)
# Add buffer time for delays
# Include in meeting notes发展
运行服务器：
python server.py运行测试：
pytest格式代码：
black server.py
ruff check server.py快速入门
由于无需API密钥，您可以立即开始使用服务器：
- 安装：
pip install -e . - 运行：
python server.py - 使用坐标测试：输入斯德哥尔摩地区的任意坐标以查找附近的站点
记录日志
日志被写入到 logs/sl_transit_mcp.log 每周轮换，每月留存。
许可证
MIT 许可证 - 详情请参阅 LICENSE 文件。