eventbrite-mcp

eventbrite-mcp

此项目由 AI（Claude Code）开发并维护。请自行斟酌使用。

适用于 Eventbrite 的 MCP 服务：你的门票和 订单、组织者数据（活动、参与者、订单）、通过 ID 查询任意公开活动， 以及公开活动搜索——Eventbrite 于 2019 年从其文档化 API 中移除了搜索， 如今该功能仅存在于面向消费者的网站上。

根据 Eventbrite 的可访问方式，提供两种数据路径：

• 文档化 API（eventbriteapi.com/v3）——使用个人 OAuth 令牌（EVENTBRITE_TOKEN，免费：创建一个）通过普通的服务端 HTTPS 访问。 为账户、组织者、按 ID 查询活动及参考工具提供支持。
• 面向消费者的发现 API（www.eventbrite.com/api/v3/destination/…）——该网站的 WAF 会拦截服务端客户端，因此搜索会通过 fetchproxy 桥接，由你自己已登录的 eventbrite.com 浏览器标签页发起（ContextMint Bridge 扩展），并复用你的已认证会话。为 eb_search_events、 eb_resolve_place、eb_event_details、eb_healthcheck 提供支持。

所有工具均为只读。

设置

npm install -g @chrischall/eventbrite-mcp

Claude Code（.mcp.json）：

{
  "mcpServers": {
    "eventbrite": {
      "command": "eventbrite-mcp",
      "env": { "EVENTBRITE_TOKEN": "your-private-token" }
    }
  }
}

• 不设置 EVENTBRITE_TOKEN 时，服务仍会启动；账户工具会在首次使用时给出清晰的错误提示，而发现工具不受影响。
• 对于发现工具：从其 发布页 安装 ContextMint Bridge（解压 chrome zip 并以未打包形式加载；目前请使用 Chrome——Safari 支持将在 ContextMint 应用中推出，该应用尚未公开下载），保持一个 eventbrite.com 标签页处于打开状态，并批准 一次性配对提示词（该提示词涉及读取搜索 POST 所需的 csrftoken Cookie）。运行 eb_healthcheck 验证连接（未设置令牌时会检查桥接；设置令牌时会检查令牌）。
• ContextMint Bridge 是 fetchproxy 浏览器扩展的新名称，来自同一维护者——fetchproxy 自身的 README 中提供了指向它的链接。 其源代码公开于 nullnet-app/contextmint-bridge： 你可以自行构建，或使用随发布包一同提供的 .sha256 文件校验发布 zip （shasum -a 256 -c contextmint-bridge-chrome-<version>.zip.sha256）。

工具

工具	路径	说明
eb_me	token	你的个人资料
eb_my_orders	token	你的门票，包含展开的活动信息
eb_my_organizations	token	主办方组织
eb_org_events / eb_org_attendees / eb_org_orders	token	主办方数据
eb_org_venues / eb_org_discounts / eb_org_ticket_groups / eb_org_webhooks	token	组织范围内的集合
eb_org_report	token	销售额 / 参加者分析，按日期范围筛选
eb_event / eb_event_description	token	根据 ID 查询任意公开活动
eb_ticket_classes / eb_ticket_class	token	活动的门票类型
eb_event_attendees / eb_event_attendee	token	每场活动的参加者（changed_since 可增量轮询）
eb_event_orders	token	每场活动的订单
eb_event_questions	token	注册问题（canned: true 表示使用标准题库）
eb_order	token	根据 ID 查询单个订单
eb_venue / eb_venue_events	token	场地详情及其活动
eb_organizer / eb_organizer_events	token	主办方个人资料及其举办的所有活动
eb_series_events	token	定期系列活动的场次
eb_user	token	公开的用户个人资料
eb_reference	token	类别 / 子类别 / 格式 / 时区 / 国家 / 地区
eb_resolve_place	token	地点 → 地点 ID（Charlotte, NC → 85981333），以及浏览分类
eb_search_events	token	面向消费者的搜索；使用 compact: true 获取精简结果，使用 aggs 获取分面
eb_event_details	token	批量查询活动详情
eb_healthcheck	token，否则使用 bridge	提供 token 时：探测 GET /users/me/ 并报告 error.kind（credential_rejected、CDN/WAF 拦截页对应的 edge_blocked、timeout、http、transport）；不提供 token 时：诊断 bridge 发现流程回退到的路径，并指出缺少 token（如果也没有 bridge，则为 no_credential）

搜索流程：eb_resolve_place {location: "Charlotte, NC"} → eb_search_events {q: "blues", place_id: "85981333", compact: true}。

eb_resolve_place 也接受原始 slug（nc--charlotte）。如果只提供城市名称， 而没有州或国家，则会拒绝请求，而不是猜测。

开发

npm install
npm test          # node suite
npm run build     # tsc + esbuild bundle

API 结构说明（已采集并验证）：docs/EVENTBRITE-API.md。项目附带了一个 Shell 级访问技能（curl + fpx，无需服务）。