关于 etix-mcp
etix-mcp 是面向 Claude 的 Etix 活动发现 MCP 服务,可搜索活动、场馆和表演者,并获取详细信息。它通过用户已登录的浏览器标签页访问 Etix 页面数据。
主要功能
- 01搜索活动、场馆和表演者
- 02获取活动及演出详情
- 03查看场馆地址与即将举行的活动
- 04将城市或邮编解析为坐标
- 05检查浏览器桥接状态
适用场景
- 01按关键词查找活动
- 02查看演出时间和票价范围
- 03浏览某场馆的近期活动
- 04将城市位置用于活动浏览
MCP 相关
MCP 服务向 Claude 提供 Etix 搜索、详情查询、地点解析和健康检查工具。请求通过 ContextMint Bridge 经由用户已登录的 Etix 浏览器标签页发送。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
npx -y etix-mcpETIX_WS_PORTOverride the fetchproxy WebSocket port (default 37149).ETIX_DEBUGSet to 1 for stderr per-request bridge timing.FETCHPROXY_WS_HOSTBind interface for the bridge (default 127.0.0.1; a literal IP only, anything else is ignored). Keep on loopback — it exists for ONE topology: a hosted child in its own network namespace.FETCHPROXY_IDENTITY_DIRWhere to store the long-term fetchproxy identity keypair (default ~/.fetchproxy/identity/; an absolute path only, anything else is ignored). Exists for a host that runs a separate child per caller, so they can share one identity.本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。
工具
5收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| keywords | string | 是 | 搜索文本——艺人、活动或场馆名称(例如 "jazz"、"Marion Meadows")。 |
详细介绍
etix-mcp
面向 Claude 的 Etix 活动发现 MCP 服务——通过自然语言搜索活动、场馆和表演者,并获取完整的活动/场馆详情。
⚠️ Etix 不提供面向公众的消费者 API,其消费者网站也设有 DataDome 反机器人防护墙。此服务会通过 ContextMint Bridge 浏览器扩展,使用你已登录的浏览器标签页,读取 etix.com 本身使用的
/ticket/api/online/...端点和服务器渲染页面。每个请求都通过你现有的会话发出——使用你的 Cookie、TLS 和 JS 上下文——就像你亲自浏览网站一样。无需 Etix 账户;此处使用的是公开的发现数据。请自行决定是否使用。
工具
| 工具 | 用途 |
|---|---|
etix_search | 按关键词搜索活动、场馆和表演者。每个类别返回若干条热门结果,每条都包含其 ID 和 etix.com 规范 URL。 |
etix_get_event | 根据 event_id 获取活动/演出的完整记录——名称、日期/时间、场馆(含地址和坐标)、主办方、票价范围以及各个定价的票档。 |
etix_get_venue | 根据 venue_id 获取场馆信息——名称、主办方、完整地址,以及该场馆即将举行的活动列表。 |
etix_find_location | 将城市名称或邮政编码解析为坐标及规范化的城市/州信息——这是基于位置浏览活动的基础工具。 |
etix_healthcheck | 端到端桥接检查——往返请求 /robots.txt,并报告失败环节(桥接服务未运行、扩展未连接,或标签页遇到 DataDome 验证)。其他工具失败时调用此工具。 |
工作原理
Etix 的消费者网站前端设有 DataDome 中间页,服务器端请求无法通过验证,因此 etix-mcp 会通过共享的 fetchproxy 桥接服务(WebSocket 位于 127.0.0.1:37149),经由你已登录且已通过验证的 etix.com 标签页发送每个请求。etix_search 会读取正常的 search/suggest JSON 端点;etix_get_event 和 etix_get_venue 会解析服务器渲染的演出/场馆页面(schema.org JSON-LD 和微数据)。已验证的端点结构请参阅 docs/ETIX-API.md。
设置
完整安装步骤请参阅 skills/etix/SKILL.md:将服务添加到 MCP 配置中,安装共享的 ContextMint Bridge 扩展,打开 etix.com,并批准一次性配对。然后运行 etix_healthcheck。
扩展的来源。 ContextMint Bridge 是更名后的 fetchproxy 浏览器扩展,由同一位维护者维护——fetchproxy 自己的 README(chrischall/fetchproxy#extension)指向该扩展。其源代码公开于 nullnet-app/contextmint-bridge:你可以自行构建(
npm run build),也可以使用旁边发布的.sha256文件校验发布 zip 文件(shasum -a 256 -c contextmint-bridge-chrome-<version>.zip.sha256)。
开发
npm ci
npm run build # tsc --noEmit + esbuild bundle → dist/bundle.js
npm test # vitest
条款确认
使用此 MCP 服务即表示你确认:它会通过 ContextMint Bridge 扩展使用你自己的 etix.com 会话;Etix 不提供面向公众的消费者 API(因此底层端点可能随时变更);这是一个非官方的 AI 开发项目,与 Etix 无关。请自行决定是否使用,并遵守 Etix 的使用条款。
许可证
MIT — 由 AI(Claude Code)开发并维护。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。