关于 PassFast
PassFast 是托管的 HTTPS MCP 服务,用于创建和管理 Apple Wallet 与 Google Wallet 通行证。它面向需要通过密钥认证的 API 生成、更新和分享通行证的 MCP 客户端。
主要功能
- 01列出并发布通行证模板
- 02生成 Apple 与 Google Wallet 通行证
- 03下载 .pkpass 文件
- 04更新或作废通行证
- 05创建分享链接和二维码
- 06管理应用、组织与密钥
适用场景
- 01通过 MCP 客户端生成双钱包通行证
- 02下载生成的 .pkpass 文件
- 03更新或作废已发行的通行证
- 04通过链接或二维码分享通行证
MCP 相关
通过 https://passfa.st/mcp 上的托管 HTTPS 服务,向 MCP 客户端提供 PassFast 通行证管理能力。使用密钥认证;此仓库提供安装元数据和配置示例,不包含本地服务二进制文件。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://passfa.st/mcpclaude mcp add --transport http st-passfa-passfast https://passfa.st/mcp{"mcpServers":{"st-passfa-passfast":{"type":"http","url":"https://passfa.st/mcp"}}}在 Cursor 中打开{"servers":{"st-passfa-passfast":{"type":"http","url":"https://passfa.st/mcp"}}}在 VS Code 中打开{"mcpServers":{"st-passfa-passfast":{"type":"http","url":"https://passfa.st/mcp"}}}{"mcpServers":{"st-passfa-passfast":{"serverUrl":"https://passfa.st/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
https://passfa.st/mcp需要授权工具
47| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| data | object | 是 | 合并到模板结构中的动态字段值。 |
| x_app_id | string | 否 | 为此次调用覆盖 X-App-Id。默认情况下省略连接标头;仅在多应用组织中设置。 |
| locations | array | 否 | 此通行证适用的 GPS 位置(显示在锁定屏幕上)。 如果提供,则覆盖模板默认值。 |
| expires_at | string | 否 | 通行证的可选到期时间戳。 |
| external_id | string | 否 | 用于跨系统查找的可选外部标识符。 |
| template_id | string | 是 | 要使用的已发布模板的 ID。 |
| wallet_type | enum | 否 | 目标钱包平台。默认为 `apple`。设为 `google` 时, 响应将返回包含 `save_url` 的 JSON 对象,而不是二进制 .pkpass 文件。 设为 `both` 时,一次调用会同时生成 Apple 和 Google 通行证,并 返回包含 `apple`、`google` 和 `warnings` 键的 JSON 对象。apple | google | both |
| max_distance | number | 否 | 与位置的最大距离(米),用于判定锁定屏幕上的相关性。 |
| get_or_create | boolean | 否 | 为 true 时,如果已存在具有相同 serial_number 且处于有效状态的通行证,则返回现有 .pkpass(200),而不是 409 错误。响应包含 `X-Pass-Existed: true` 标头。如果现有通行证已作废或过期,则返回 409。为 false(默认值)时,重复的序列号始终返回 409。 |
| relevant_date | string | 否 | 通行证相关的 ISO 8601 日期(显示在锁定屏幕上)。 |
| serial_number | string | 是 | 此通行证的唯一序列号。 |
| strip_image_id | string | 否 | 仅对此通行证覆盖模板的 strip/hero 图片。引用的 图片必须属于同一应用,且用途为 `strip`(或 `strip_*` 变体)。此设置会原子性地应用于 Apple `strip.png` 和 Google `heroImage` (`wallet_type: "both"` 时,两个钱包使用相同值)。省略或发送 `null` 可使用模板的 strip 图片。 |
详细介绍
PassFast MCP
适用于 PassFast 的远程 HTTPS Model Context Protocol 服务,可从任意 MCP 客户端(Cursor、Claude、ChatGPT、Codex、Grok)创建 Apple Wallet + Google Wallet 通行证。
| 端点 | https://passfa.st/mcp |
| 别名 | https://passfa.st/api/mcp |
| 文档 | https://passfa.st/docs/mcp · https://passfa.st/mcp.md |
| OpenAPI | https://passfa.st/openapi.yaml |
| 注册 / 密钥 | https://passfa.st/signup |
| 隐私 / 条款 | https://passfa.st/privacy · https://passfa.st/terms |
此仓库是供市场目录(官方 MCP Registry、Grok Build 插件、开放目录)使用的公开元数据 + 安装套件。服务本身托管在 passfa.st 上,此处不提供本地 stdio 二进制文件。
身份验证
Authorization: Bearer sk_live_YOUR_SECRET_KEY
X-App-Id: YOUR_APP_ID # optional for single-app orgs
- 仅支持密钥(
sk_live_)。不接受 Publishablepk_live_密钥。 - 不使用 OAuth,也不需要 PassFast Agent 账户——MCP 客户端就是 Agent。
- 成员/邀请工具需要用户 JWT,不属于基于密钥的 MCP v1 范围。
安装
Cursor
将 cursor/mcp.json 复制到 ~/.cursor/mcp.json 或项目的 .cursor/mcp.json,然后替换占位符。
Claude(HTTP)
{
"mcpServers": {
"passfast": {
"type": "http",
"url": "https://passfa.st/mcp",
"headers": {
"Authorization": "Bearer sk_live_YOUR_SECRET_KEY",
"X-App-Id": "YOUR_APP_ID"
}
}
}
}
仅支持 stdio 的客户端:使用 npx mcp-remote https://passfa.st/mcp,并通过客户端的环境变量/标头支持配置相同的标头。
通用 / 注册表
有关官方 MCP Registry 远程描述符(Streamable HTTP + 身份验证标头),请参阅 server.json。
Agent 可以做什么
- 列出 / 发布模板;生成双钱包通行证;下载
.pkpass - 更新 / 作废通行证;分享链接 + QR 码
- 上传图片和签名凭据;管理应用 / 组织 / API 密钥
- 计费方式与 HTTP API 相同(参见 https://passfa.st/#pricing)
入门提示词
市场提交
准备好的列表信息位于 listings/ 下。状态检查清单:SUBMIT.md。
许可证
MIT © Aberkane Software
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。