关于 GTFS Scorecard
GTFS Scorecard 为公开的 GTFS Schedule 数据源评分,并将验证器提示转化为易懂的修复建议。交通机构和数据源审核者可用其命令行工具评分,也可通过只读 MCP 服务查看已发布的等级、修复建议和历史记录。
主要功能
- 01为 GTFS Schedule ZIP 数据源评分
- 02输出等级与分类得分
- 03将验证器提示转为修复建议
- 04搜索已跟踪机构及评分卡
- 05查看等级历史
适用场景
- 01发布前检查 GTFS 数据源
- 02查找验证器提示对应的易懂修复建议
- 03查看机构评分卡与等级历史
MCP 相关
只读 stdio MCP 服务支持客户端搜索已跟踪机构、获取评分卡和修复建议、查看等级历史及解释验证器提示。它读取已发布的评分卡,无需密钥。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
9收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| grade | string | 否 | 字母等级 A-F |
| limit | integer | 否 | 最大结果数(默认 20) |
| query | string | 否 | 名称片段或精确的机构 ID |
| state | string | 否 | 旧版州/省名称筛选器;优先使用 subdivision |
| country | string | 否 | ISO 3166-1 alpha-2 国家/地区代码,例如 CA |
| subdivision | string | 否 | ISO 3166-2 代码或行政区名称,例如 CA-ON 或 Ontario |
详细介绍
gtfs-scorecard
GTFS Scorecard 背后的评分流水线、命令行工具和只读 MCP 服务。它为公共 GTFS Schedule 数据源评分,并将验证器通知转化为通俗易懂的修复建议。
功能
scorecard try <feed-url>使用 MobilityData 验证器为一个 GTFS Schedule zip 文件评分(PATH中必须有 Java 17 或更高版本),并打印等级、 各类别得分和优先修复项。scorecard-mcp是一个基于 stdio 的只读 Model Context Protocol 服务。它的 工具读取 gtfsscorecard.org 上已发布的评分卡:搜索受跟踪机构、 获取评分卡及其修复建议、读取数据源的等级历史记录,以及解释验证器发现的问题。它无需密钥,也不提供写入功能。gtfs-scorecard是使用发行包名称的同一个 MCP 服务,因此uvx gtfs-scorecard会启动它。
Python 导入包名为 scorecard_pipeline。该发行包在 1.5.1 之前名为 scorecard-pipeline;PyPI 认为该名称与
一个现有项目过于相似,因此拒绝了这个名称,且该名称下没有上传过任何内容。
安装
uvx gtfs-scorecard
uvx --from gtfs-scorecard scorecard try https://example.org/gtfs.zip
pip install gtfs-scorecard
第一条命令会启动 MCP 服务。第二条命令会运行命令行工具。该工具有自己的名称,因此 uvx 需要使用 --from 才能找到提供它的包。
请查看 https://pypi.org/project/gtfs-scorecard/ 了解已发布的版本。
要运行尚未发布的代码,请从代码仓库安装:
uvx --from "git+https://github.com/ChelseaKR/gtfs-scorecard#subdirectory=pipeline" scorecard-mcp
连接助手
以下 MCP 客户端配置会从 PyPI 启动服务:
{
"mcpServers": {
"gtfs-scorecard": {
"command": "uvx",
"args": ["gtfs-scorecard"]
}
}
}
设置 SCORECARD_BASE_URL,使其指向一个分支或本地预览版本。
更多信息
- 网站和评分卡:https://gtfsscorecard.org/
- 面向支持多个机构的项目的报告包:https://gtfsscorecard.org/bundle/
- MCP 工具及其拒绝提供的信息:https://github.com/ChelseaKR/gtfs-scorecard/blob/main/docs/mcp.md
- 根据数据源等级决定是否允许构建的 GitHub Action:https://github.com/marketplace/actions/gtfs-scorecard-gate
- 源代码、问题反馈和变更日志:https://github.com/ChelseaKR/gtfs-scorecard
Apache-2.0。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。