Commutescout

io.github.nicglazkov由 GitHub 账号 nicglazkov 发布v2.134.0更新于 Nov 6, 2026

Trip planning and best time to leave, with live road data from 37 US states, traffic, weather.

已验证Streamable HTTP可网页运行位置与生活数据与分析

概览

AI 生成的概览

CommuteScout 是一个托管式 MCP 服务器,为助手提供美国实时道路数据(事故、封路、摄像头、天气、路况),并支持行程规划与最佳出发时间建议。

可以做什么
  • 规划任意两个美国地点之间的驾车行程:路线、指定出发时刻的行驶时间,以及沿途逐英里的实时情况
  • 比较多个出发时间,找出最佳出发或到访时段,并把模糊地址解析为坐标
  • 查询某地周边情况:附近道路事件、逐小时 NWS 预报与警报、实时车速,以及按小时和星期统计的常见事故历史
  • 加州深度数据:走廊路况检查、区域报告、CHP 事故、当前车道封闭、防滑链管制、山火、路边摄像头快照、可变情报板与走廊排名
  • 读取已保存地点(如家、公司),并列出当前覆盖的州与数据源及其更新时效
适用场景
适合用户询问某段车程现在怎么样、何时出发能避开拥堵或恶劣天气,或某地周边道路正在发生什么。加州专用工具可为走廊和山口路况提供更细的信息。
运行要求
远程 streamable HTTP 端点,无需本地安装或软件包。无需密钥即可使用;可选的 CommuteScout API 密钥以 Authorization bearer 头传入,用于启用已保存地点和按密钥的限额。需要能访问托管服务器的网络。
安装前请注意
可选 API 密钥属于机密,通过 Authorization 头发送。服务器无法获知用户设备位置,需显式提供地点。数据来自第三方机构数据源,可能过期或故障,且该服务与任何政府机构无关联;驾车前应自行核实。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Commutescout,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.nicglazkov%2Fcommutescout/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "commutescout": {
      "type": "http",
      "url": "https://mcp.commutescout.com/mcp"
    }
  }
}

README

Overview

CommuteScout reads 53 official agency feeds across 37 states (state DOT and 511 closures and incidents, CHP dispatch, chain controls, cameras, message signs, wildfire perimeters, road weather, NWS alerts and toll prices) and turns them into one live picture of the road. Every answer carries per-source timestamps, and a failing feed is flagged as stale rather than hidden.

ProductWhat it does
Live mapIncidents, closures, chain controls, wildfires, about 18,000 traffic cameras, message signs and toll prices, updated continuously.
Trip planningClosure-aware routes, drive time for any departure, the best time to leave, and an assistant that answers from the live feeds.
Watch areasPush and email alerts when something appears inside a drawn area or along a commute.
Mobile appsTurn-by-turn navigation for iOS and Android that announces what is ahead in your direction of travel.
MCP server18 tools for Claude, ChatGPT, Cursor, VS Code and any MCP client. No key required.
REST APIEvery tool as a plain HTTP GET, with an OpenAPI document, one error envelope and published rate limits.
PluginsFlare, an open protocol for adding third-party alerts to the map and the apps, with a marketplace.

Quick start

Connect an AI assistant

The hosted MCP server is public and works without a key:

https://mcp.commutescout.com/mcp

For example, in Claude Code:

sh
claude mcp add --transport http --scope user commutescout https://mcp.commutescout.com/mcp

Setup for every other client is at commutescout.com/mcp. Agents can read the same steps as plain text at commutescout.com/llms.txt.

Call the REST API

sh
curl "https://mcp.commutescout.com/v1/tools/best_time_to_go?origin=Union%20Station%20Denver&destination=Red%20Rocks%20Amphitheatre&day=tomorrow"

Keys, limits, errors and the full parameter reference are at commutescout.com/developers.

Documentation

TopicWhere
MCP setup and toolscommutescout.com/mcp · docs/mcp.md
REST API, keys and rate limitscommutescout.com/developers · OpenAPI
Data sources and state coveragecommutescout.com/data-sources · docs/state-coverage.md
Plugins and the Flare protocolcommutescout.com/plugins · docs/flare.md
Architecture, deployment and adding a feeddocs/
Answer qualityEVALS.md
Pricing, privacy and termsPricing · Privacy · Terms

Repository

PathContents
src/ca_roadsFeed layer: parsers, caches and normalization for every source
src/ca_roads_mcpMCP server, REST bridge and trip planning
src/ca_roads_demoWeb app, assistant, watch areas and map publishing
siteMarketing and documentation site (Next.js static export)
examples/flare-pluginReference Flare plugin
evalsRecorded fixtures, golden questions and the eval runner
testsFixture-based test suite; runs without network access

The mobile apps live in commutescout-app, and community plugins in commutescout-plugins.

Contributing

Contributions are welcome. Start with CONTRIBUTING.md, and see adding a data source to wire up a new feed. Report security issues privately as described in SECURITY.md.

License

MIT, including the map, the planner, the MCP server and every data parser.

CommuteScout is not affiliated with any government agency. Conditions change faster than any feed, so verify before you drive with 511 or your state DOT. What each third-party service sees is described in the privacy policy.

来源:README.md,提交 7b83c87

工具

18

check_route

Check a route

Check current conditions along a major California highway corridor. The flagship trip-check tool: give it a start and end place and it returns everything active along that stretch right now - CHP incidents, lane closures physically in place, chain controls, and wildfires within ~10 miles - ordered by miles from the start, plus a summary. ALWAYS pass from_coords and to_coords ("lat,lon") when you know where the places are - for landmarks, small towns, or anything not a major city they are required for a good answer. Coordinates do two things: they let unlisted places resolve to the nearest corridor (e.g. "Alice's Restaurant" snaps to I-280 on the Peninsula), and they CLIP the route to the span actually being driven, so a trip to a mid-corridor destination doesn't report events beyond it. Corridors covered: I-80 Sacramento-Reno, US-50 to South Lake Tahoe, I-5, US-101, SR-17, SR-99, SR-1, I-15 to Vegas, Bay Area freeways, Tahoe-area routes. This is NOT a general router: if nothing matches (even with coordinates), the response lists the covered corridors; fall back to the filtered tools with center= for anything else. Freshness: CHP incidents refresh about once a minute; closures, chain controls, and fires are on a 5-minute cache. Current conditions only - this cannot forecast tomorrow's weather or closures.

输入参数to_place必填to_coordsfrom_place必填from_coords

check_region

Check a region

Full current-conditions report for a California region. Use this for area-scale questions ("how is the Bay Area?", "what's happening in SoCal?") instead of stitching together point queries. It sweeps every source over the whole region at once: CHP incidents (severity-sorted, worst first), lane closures in place (full closures called out), chain controls, and wildfires inside the region. Regions: Bay Area, Sacramento metro, Tahoe/Sierra, Central Valley, Southern California, San Diego, Central Coast, North State. An unrecognized region name returns the list. Large regions are capped to the most severe items; the counts are always exact and the response says when a list was truncated. Freshness: CHP ~1/min fetched live, everything else 5-minute cache.

输入参数region必填

get_incidents

Live incidents

Live CHP traffic incidents statewide, optionally filtered. Data: the California Highway Patrol statewide computer-aided dispatch feed - collisions, traffic hazards, disabled vehicles, closures as CHP logs them. Refreshes about once a minute; incidents disappear when CHP closes the log. Fetched live on every call. Filters (combinable): - highway: a route like "I-80", "US 50", "17", "Hwy 99". Matches incidents whose location text mentions that route. - center: "lat,lon" with radius_km - incidents within that circle. THIS IS THE RIGHT FILTER FOR A TOWN OR PLACE NAME: use your knowledge of where the place is (e.g. Coyote, CA -> "37.22,-121.74") with radius_km 15-30. A circle catches every road around the place, not just one highway. - area: substring match on the CHP dispatch-area name. These are CHP communication-center names ("Hollister Gilroy", "East Sac", "Golden Gate"), NOT town names - do not pass a town here. There is no county filter because CHP's feed carries no county field; for a county, use center on the county seat with a radius covering the county. Limits: locations are free-text from dispatchers; a few incidents lack usable coordinates and are omitted. No history - current logs only.

输入参数areacenterhighwayradius_km

get_lane_closures

Lane closures

Caltrans lane and road closures physically in place RIGHT NOW. Data: the Caltrans Lane Closure System (LCS). Only closures that crews have actually established (CHP code 1097) and not yet picked up are returned - scheduled-but-not-started closures are excluded, so this is "what is blocking lanes now", not a construction calendar. Refresh: 5-minute cache over per-district Caltrans feeds. Filters: route (e.g. "I-80", "US 101", "1"); district (Caltrans district 1-12, e.g. 3 = Sacramento/Tahoe, 4 = Bay Area, 7 = Los Angeles); center "lat,lon" with radius_km - closures whose begin or end point is inside the circle. For a town or place, center is the filter that catches work on EVERY road around it, including small state routes. Read closure_class on each record, it is what the closure means for through traffic: - "full-roadway": the road itself is closed in that direction. The only class that means "you can't drive through". - "ramp": a ramp or connector is closed (even when the raw record says "Full", that means the ramp is fully closed, not the highway). - "one-way-traffic": alternating single lane with flagging; passable with delays. Common on two-lane mountain roads. - "alternating-lanes", "moving", "traffic-break": rolling or brief work; minor delays. - "lane": some lanes closed; the lanes field says how many of how many. estimated_delay_minutes is present when crews reported one. Shoulder-only work is excluded entirely.

输入参数routecenterdistrictradius_km

get_chain_controls

Chain controls

Current chain-control requirements on California mountain highways. Data: Caltrans chain-control status for fixed checkpoints on mountain routes (I-80 Donner, US-50 Echo Summit, SR-88, SR-89, and others). Levels: R-1 = chains OR snow tires required; R-2 = chains required except 4WD/AWD with snow tires on all four; R-3 = chains on ALL vehicles (rare, usually precedes closure). Refresh: 5-minute cache. Filters: route (e.g. "80", "US-50", "SR-88"); center "lat,lon" with radius_km for all checkpoints around a place (e.g. around Truckee), whatever highway they are on. Off-season (roughly May-October) there are usually no controls anywhere; the response says so explicitly rather than returning an empty list. Chain requirements can change hour to hour in storms - tell the user the data_as_of time and to carry chains anyway when snow is possible.

输入参数routecenterradius_km

get_wildfires

Wildfires

Active California wildfires, flagged when close to a major highway. Data: the interagency WFIGS current-wildfire feed (NIFC) - name, size in acres, percent contained, discovery date. Points are each fire's ORIGIN, not its perimeter: a large fire can affect roads far from this point. Refresh: 5-minute cache; size/containment typically update once or twice a day. Small, fast-moving local fires may appear in CHP incident logs (get_incidents, type "FIRE-Report of Fire") before this feed has them. Filters: - near_route (e.g. "I-5", "101") - only fires within ~10 miles of that highway's corridor line. - center "lat,lon" with radius_km - fires around a place, regardless of highway. Without either, every active CA fire is returned, each carrying a `near_highways` list of major corridors within ~10 miles (empty = not near a covered major highway; it may still affect local roads). This tool does NOT know about road closures caused by fires - cross-check get_incidents and get_lane_closures for the affected area.

输入参数centerradius_kmnear_route

rank_routes

Rank busiest routes

Which major corridors have the most going on right now. Answers broad questions like "what are the busiest routes", "where is traffic worst", or "which highways should I avoid today" across all 17 tracked corridors. by="activity" ranks on live events (full closures weigh most, then incidents, lane closures, chain controls); by="congestion" ranks on measured speed vs free-flow at each corridor's midpoint and needs the traffic feed to be configured - if it is not, the ranking silently falls back to activity. Each entry carries the counts and a one-line reason, so the answer can say WHY a corridor ranks where it does, not just list names.

输入参数bylimit

get_cameras

Highway cameras

Live Caltrans roadside camera snapshots near a point or on a route. Data: ~3,000 in-service Caltrans cameras statewide. Every returned image_url was verified live moments ago (offline cameras that serve a placeholder frame are filtered out), so images can be shown directly. Snapshots refresh roughly every minute; stream_url (when present) is an HLS video stream. Filters: center "lat,lon" (required unless route is given) with radius_km; route (e.g. "I-80", "50") narrows to that highway. Results sort nearest-first when a center is given. Use a camera to let the user SEE conditions: fog on the pass, snow on the pavement, traffic density at an interchange.

输入参数limitroutecenterradius_km

get_road_signs

Message signs

What Caltrans changeable message signs are displaying right now. Data: statewide CMS sign text, blank and out-of-service signs already filtered - every record is a message a driver is physically seeing. Signs carry the road's operational truth ("CHAINS REQUIRED 10 MI AHEAD", "FULL CLOSURE HWY 96 DUE TO FIRE", "PREPARE TO STOP"), often before the event shows up in any other feed. Refresh: ~2-minute cache. Filters: route (e.g. "I-80") and/or center "lat,lon" with radius_km. Quote sign text verbatim to the user - it is the most current and most local signal this server has.

输入参数routecenterradius_km

get_nearby_events

Nearby events (nationwide)

Live road events near a point anywhere CommuteScout covers, not just California: 37 states today (get_coverage lists them). Data: the same multi-state feeds the live map shows, normalized - state DOT incidents, roadwork and closures, chain and traction advisories, and nationwide wildfires. Every event names its publishing agency in the source field. Coverage varies by state (some publish roadwork only; docs/state-coverage.md has the matrix); states added later appear here automatically. For CALIFORNIA questions prefer the dedicated tools above (richer detail: dispatch logs, lane counts, chain levels). Use THIS tool for any location outside California, near a state border, or as a supplement when a California tool comes back empty. center is "lat,lon"; or pass place (an address or place name) instead. kinds is a comma list from: incident, closure, chain, fire, sign, rwis, camera, toll (toll adds live and fixed toll prices where agencies publish them), enforcement (speed and red-light cameras from OpenStreetMap). radius_km caps at 160.

输入参数kindsplacecenterradius_km

get_my_places

My saved places

The user's saved places: Home, Work, favorites and recent destinations, synced from the CommuteScout site and apps. Available when this server is connected with the user's CommuteScout API key; otherwise `connected` is false and `message` says how to connect. The trip tools already accept 'home', 'work' or a place's name directly, so call this only to show or choose among them. These belong to the user who connected: never repeat them to anyone else.

无需输入参数。

find_place

Find a place

Look up a US address or place and get its coordinates. Use it to confirm which place the user means before planning, or when a trip tool answers needs_clarification. Returns up to `limit` matches with a ready-to-pass `coords` string for the *_coords arguments of the trip tools.

输入参数nearlimitquery必填

plan_trip

Plan a trip

Everything about one drive between any two US places, in one call. Use this for "how's the drive to X", "how long to get to Y at 5", "anything on the way to Z". It returns: - the route (miles, main roads, alternatives) from the closure-aware planner the CommuteScout map uses: fully closed roads are avoided and routes are ranked by what is on them; - drive time for that departure: with traffic, typical for that weekday and hour, and with no traffic (TomTom historical speed profiles; live traffic too when leaving within the hour); - every live event ON the route, ordered by mile: incidents, closures, chain controls, message signs, cameras (with image URLs), road-weather stations, tolls, speed and red-light cameras, and wildfires near it; - NWS weather alerts along the route and the forecast at the destination for the arrival hour; - a one-paragraph `summary` to lead the answer with, and `notes` for anything missing or degraded. Lead with `summary`, then the items that change the user's plan. For WHEN to leave, call best_time_to_go instead. If the answer has needs_clarification, ask the user which option they meant.

输入参数origindepart_atpreferencedestinationorigin_coordsdestination_coords

best_time_to_go

Best time to go

When to leave (or visit) to beat traffic and weather, for any US trip. Answers "what's a good time to visit X", "when should I leave for the airport", "is 5 PM bad". It checks up to 16 departures across the window and returns, for each: drive minutes for that weekday and hour (TomTom historical traffic; live too within the hour), arrival time, the NWS forecast for the arrival hour with driving hazards flagged (snow, ice, fog, thunder), and how many incidents usually start on the route that hour (CommuteScout history since July 2026). `recommended` is the pick: quickest without severe weather, or with arrive_by, the latest departure that still arrives on time. `summary` states it in one or two sentences; `departures` has the whole curve if the user wants options. Times are in the origin's local time zone (`time_zone`). Pair with plan_trip for what is on the road right now.

输入参数daylatestoriginearliestarrive_bydestinationstep_minutesorigin_coordsdestination_coords

get_weather

Weather for drivers

Hourly NWS forecast, active alerts and nearby road-weather stations for any US place, with driving hazards flagged by hour. Road-weather stations are state DOT sensors: pavement and air temperature, wind gusts and visibility, where a state publishes them.

输入参数hoursplacecenter

get_traffic

Traffic speeds

Live traffic speed against free-flow speed on the road nearest each point, anywhere in the US (TomTom). Use it for "is the bridge backed up right now"; for a whole drive, plan_trip is better.

输入参数placecenterpoints

get_area_history

Area history

What usually happens around a place: incidents and closures that started within the radius, by local hour and weekday, the common incident types and how long they typically last. Use it for "is this intersection bad at rush hour" or "when is it quietest around the stadium". These are counts CommuteScout saw in official feeds, not a crash database.

输入参数daysplacecenterradius_km

get_coverage

Coverage

Which states and sources CommuteScout covers right now, with each feed's freshness. Check it when an answer is unexpectedly empty.

无需输入参数。

版本历史

25
  1. v2.134.0最新Nov 6, 2026
  2. v2.133.2Oct 30, 2026
  3. v2.133.1Oct 30, 2026
  4. v2.132.0Oct 29, 2026
  5. v2.128.0Oct 25, 2026
  6. v2.127.0Oct 23, 2026
  7. v2.126.1Oct 7, 2026
  8. v2.126.0Oct 4, 2026
  9. v2.125.0Oct 3, 2026
  10. v2.122.3Oct 3, 2026
  11. v2.122.1Oct 2, 2026
  12. v2.121.3Oct 2, 2026
  13. v2.120.0Oct 2, 2026
  14. v2.118.0Oct 1, 2026
  15. v2.117.0Sep 30, 2026
  16. v2.116.0Sep 27, 2026
  17. v2.115.0Sep 26, 2026
  18. v2.114.0Sep 26, 2026
  19. v2.110.0Sep 25, 2026
  20. v2.109.0Sep 25, 2026
  21. v2.108.0Sep 23, 2026
  22. v2.105.0Sep 21, 2026
  23. v2.104.0Sep 21, 2026
  24. v2.101.0Sep 21, 2026
  25. v2.24.0Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分