accessoticketing-mcp

accessoticketing-mcp

用于 accesso Passport 手机票务链接 的 MCP 服务——这是场馆在你购票后通过电子邮件发送给你的 URL。读取订单及其中的每张入场票、可扫描的条形码，以及 Google Wallet 保存链接。

accesso 为许多主题公园、水上乐园、营地、博物馆和节庆活动提供票务服务，因此一个服务即可适用于所有这些场所：商家信息编码在链接中。

由 AI（Claude Code）开发和维护。请自行斟酌使用。

所需条件

无需登录。 这些链接包含自己的凭据——查询字符串中的 oToken 用于授权读取。无需账户、密码、浏览器会话，也没有反机器人屏障。

警告

这也意味着链接就是机密。任何持有链接的人都能查看并添加订单中的票。请像对待密码一样保管：不要将其粘贴到问题、日志或聊天中。此服务会在自身输出和错误消息中对令牌进行脱敏。

安装

npx -y @chrischall/accessoticketing-mcp

// claude_desktop_config.json / .mcp.json
{
  "mcpServers": {
    "accessoticketing": {
      "command": "npx",
      "args": ["-y", "@chrischall/accessoticketing-mcp"],
      "env": { "ACCESSO_TICKET_URL": "https://media-engine.na3.accessoticketing.com/tickets/v1/..." }
    }
  }
}

ACCESSO_TICKET_URL 为可选项——设置后，每次调用就无需传入 url。未设置时，服务也能正常启动，并会在首次使用时提示缺少链接。

变量	必填	用途
ACCESSO_TICKET_URL	否	默认票务链接；调用工具时未传入 url 则使用此链接。
ACCESSO_OUTPUT_DIR	否	accesso_save_barcodes 写入 PNG 文件的位置。默认为当前工作目录；若当前工作目录为 /（Claude Desktop），则默认为 ~/Downloads。
ACCESSO_NO_FILE_OUTPUT	否	当文件系统不属于用户（例如托管部署）时设为 1，以便条形码以内联形式返回。

工具

工具	功能
accesso_get_order	订单及其中的每张入场票：产品、参与者、日期、开始时间和说明。默认返回精简的逐票列表；设置 view: "full" 则返回解析出的所有字段。
accesso_get_ticket	按 index 返回一张完整的入场票。
accesso_save_barcodes	写入条形码 PNG 文件并返回路径，或以内联形式返回图像。
accesso_get_wallet_passes	返回票券的 Google Wallet 保存链接。
accesso_resolve_link	解开电子邮件点击追踪链接，获取其隐藏的 accesso URL。
accesso_healthcheck	确认服务是否可访问，以及是否已配置默认链接。

此处没有任何操作会修改订单。除 accesso_save_barcodes 外，所有工具均为只读；该工具会将 PNG 文件写入磁盘（绝不覆盖已有文件），除非要求以内联图像形式返回。

> what do we have booked tomorrow?
9:00 AM   Tiny Trekkers Full-Day (Ages 4-7)   — one participant
9:00 AM   Whitewater Kayak Camp I: Intro      — two participants
all-day   Lunch / Snack / Early Drop-Off      — nine more admissions

Shell 调用技能

更喜欢使用 Shell？skills/accesso-tickets/ 能通过 curl 和一个无依赖解析器完成相同的读取操作，无需运行服务。它随软件包一同发布。

数据说明

• date / time 是商家的当地墙上时钟时间字符串，不包含时区信息。它们会原样传递，不做转换。
• 商家专属的详情行（Guest Number、Web Sales ID 等）会以通用方式收集到 details 中，因此即使场所从未经过测试，也能正常使用。
• 过期链接会返回 HTTP 200，而不是错误状态——服务会检测响应正文并提示链接已过期，而不是报告票数为零。

开发

npm install
npm run build
npm test
npm run test:coverage   # 100% thresholds, enforced in CI

请求和响应结构示例见 docs/ACCESSO-API.md；仓库规范见 CLAUDE.md。

许可证

MIT