关于 VenuNite Events
VenuNite Events 是面向美国活动发现者的托管事件搜索 MCP 服务，可按地点、日期、兴趣和预算查找活动。搜索结果包含活动详情与来源链接，搜索无需账户或 API 密钥。
主要功能
- 01按地点和日期搜索活动
- 02按兴趣和预算筛选
- 03提供活动详情与来源链接
- 04创建归属明确的票务交接链接
适用场景
- 01查找周末的本地现场音乐活动
- 02按预算筛选社区活动
- 03寻找适合家庭的活动
- 04为选定活动创建票务链接
MCP 相关
通过 Streamable HTTP 向 MCP 客户端提供活动搜索工具，以及需要 VenuNite API 密钥的票务交接工具。搜索无需认证。
配置
远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。
https://mcp.venunite.com/v1/mcp/claude mcp add --transport http venunite-events https://mcp.venunite.com/v1/mcp/{"mcpServers":{"venunite-events":{"type":"http","url":"https://mcp.venunite.com/v1/mcp/"}}}在 Cursor 中打开{"servers":{"venunite-events":{"type":"http","url":"https://mcp.venunite.com/v1/mcp/"}}}在 VS Code 中打开{"mcpServers":{"venunite-events":{"type":"http","url":"https://mcp.venunite.com/v1/mcp/"}}}{"mcpServers":{"venunite-events":{"serverUrl":"https://mcp.venunite.com/v1/mcp/"}}}命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
https://mcp.venunite.com/v1/mcp/需要授权工具
2| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| sort | enum | 否 | 排序依据。结果按时区中的日历日展示；排序只影响每天内部的顺序。提供 query_text 时，服务器会在所有排序方式下选出与活动文本和场地氛围最匹配的结果，排序仅用于排列这些结果。未提供 query_text 时，结果数量上限由整个日期范围内的各天共享：在范围内开始的活动排在已开始的活动之前，每天按排序轴贡献下一个活动。date | distance | demand | relevance |
| limit | integer | 否 | 要返回的活动数量。默认值为 20。用户只要求推荐一个活动时，建议设置较小值（5–10）。 |
| date_end | string | 否 | 搜索范围的 ISO-8601 结束时间（不包含），包括本地 UTC 偏移量。默认值：date_start 起 14 天。也接受 now、today、tonight、tomorrow 和 this weekend，并按调用方时区解析。'Tonight' → date_start + 6 hours。'Next weekend' → date_start + 2 days。恰好在 date_end 开始的活动不在此范围内。 |
| max_cost | number | 否 | 活动费用上限，单位为 USD。'cheap' ≈ 15，'affordable' ≈ 30，'under $X' → X。未列出价格的活动仍会出现在结果中（大多数活动都未列出价格），因此应将其价格标为未经核实，而不是排除。max_cost=0 仅返回已确认免费的活动。用户未限定价格时请留空。 |
| min_cost | number | 否 | 活动费用下限。很少有用——仅在用户明确排除免费活动时设置。 |
| timezone | string | 否 | IANA 时区（例如 'America/New_York'），用于对结果进行日历日分组。默认值为 UTC；请传入用户的本地时区，使“今天／明天”的日期分组与其时钟一致。 |
| vibe_tags | array | 否 | 规范的氛围标签词汇表。包含用户明确提出或强烈暗示的标签。重要：标签 `queer-friendly`、`family-friendly`、`all-ages`、`18-plus`、`21-plus` 是硬性筛选条件——只有用户明确要求该属性时才添加。用户只说“今晚找点有趣的事”时添加 `family-friendly` 会排除大多数活动。 |
| categories | array | 否 | 活动类别。将用户意图映射为类别：'live music' → music，'standup' → comedy，'trivia night' → trivia-games，'art opening' → arts-culture。'anything to do' → 省略（不筛选类别）。 |
| center_lat | number | 否 | 纬度（仅当已有精确坐标时使用；否则传入 place_name）。 |
| center_lng | number | 否 | 经度（与 center_lat 配对）。 |
| date_match | enum | 否 | overlap 会包含在该时间范围内仍在进行的活动，例如多日节庆或前一晚开始的演出；恰好在 date_start 结束的活动会被排除。starts_within 要求活动在 date_start 或之后、date_end 之前开始。用户询问明天、指定日期、今晚或本周末开始的活动时，优先使用 starts_within。用户询问当前正在进行的活动或希望查找持续性活动时，使用 overlap。overlap | starts_within |
| date_start | string | 否 | 搜索范围的 ISO-8601 起始时间（包含），包括本地 UTC 偏移量。默认值：now。也接受 now、today、tonight、tomorrow 和 this weekend，并按调用方时区解析。对于 'tonight'，传入 now。对于 'this weekend'，传入即将到来的周六午夜。timezone 字段控制日期分组，不控制解析：不带偏移量的日期时间会按 UTC 解释。用户希望查找特定日期或晚上开始的活动时，使用 date_match=starts_within。 |
| local_only | boolean | 否 | 当用户的查询暗示“就在我附近”时设为 true，例如“我这条街上有什么活动”“今晚附近有什么”“离我近”。无论 radius_miles 是否更大，服务器都会根据本地人口密度将实际半径限制在社区级上限（城市 ≤10mi、郊区 ≤30mi、乡村 ≤50mi）。相比猜测一个较小半径，优先使用此选项——服务器了解当地人口密度，而你不了解。 |
| place_name | string | 否 | 用户提及地点时填写易读的位置名称：'Westminster, CO' 或 'Five Points Denver'。有地点名称时，优先使用它，而不是猜测 lat/lng；已有的精确坐标优先。城市名称有歧义时，务必包含州缩写。无法解析的地点会返回 location_unresolved；请更正地点或使用已知坐标，而不是删除地点条件。 |
| query_text | string | 否 | 从用户查询中提取的自由文本氛围描述。保持简短，例如 'chill jazz' 或 'loud rock club'。如果用户的请求纯粹基于地理位置／标签（例如“我附近今晚有喜剧演出吗”），则省略。 |
| state_hint | string | 否 | 用于消除 place_name 歧义的两字母州缩写（例如 place_name 为 'Frederick'，state_hint 为 'MD'）。place_name 已包含州名时无需填写。 |
| radius_miles | number | 否 | 搜索半径，单位为英里。省略此字段可让服务器根据人口密度选择默认值：人口密集的大都市（Chicago、NYC）为 5mi，郊区为 15mi，乡村为 25mi。仅当用户的措辞暗示特定范围时才传入明确值： - 'walking distance' / 'on my block' → 2-3 - 人口密集的市中心或街区中的 'near me' → 5-7 - 郊区中的 'near me' → 10-15 - 'metro area' / 'anywhere in <city>' → 25-30 - 乡村地区的 'near me' 或 'within driving distance' → 25-50 对于在 Lincolnwood、Chicago 或其他高密度城市地区询问“今晚有什么活动”的用户：省略此字段。在这些地区传入 15 会带来其他街区 8-10 英里外的活动，效果不如基于人口密度的默认值。 范围为 0.5 到 500。超出范围的值会导致整个调用失败并返回零个活动——不会自动截断，因此不要猜测，应省略此字段。不确定本地人口密度时，请使用 'local_only: true'，而不要指定较小半径。 |
| max_events_per_venue | integer | 否 | 每个场地的多样性上限。默认为 1——每个场地最多贡献一个活动，从而提供多样化的“正在举办什么”活动列表。对于“<specific venue> 正在举办什么”这类用户期待同一场地有多个演出的查询，可提高到 3–5。 |
| include_unknown_prices | boolean | 否 | 包含无法确定入场价格的活动。默认为 true，可保留广泛的发现范围；此时，正向价格范围也可能包含价格未知的活动，必须标记为未经核实。false 则仅保留列明价格的活动；大多数活动都没有列明价格，因此结果可能为空，而且仅凭“低于 $X”并不足以将其设为 false。当结果不超过三条时，applied_filters.available_if_relaxed 会报告同一搜索在包含未知价格活动时返回的数量。此设置绝不会放宽 max_cost=0 的已证实免费要求。 |
详细介绍
VenuNite 活动
按地点、日期、兴趣和预算查找美国的音乐会、喜剧、戏剧、问答活动、节庆、社区活动和家庭活动。结果包含活动详情和来源链接。覆盖范围因地点而异。
此代码库包含 VenuNite 托管 MCP 服务的公开客户端配置。搜索无需账户、API 密钥或本地服务安装。客户端订阅和模型用量由客户端提供商管理。
Streamable HTTP 端点： https://mcp.venunite.com/v1/mcp/
免费个人使用和付费使用
| 访问方式 | 每分钟调用次数 | 每天调用次数 | 每次搜索结果数 | 搜索范围 |
|---|---|---|---|---|
| 无需注册或密钥 | 30 | 每个保留的签名传输会话 100 次 | 20 | 90 天 |
| 可选免费账户密钥 | 30 | 每个账户 500 次，所有密钥共享 | 20 | 90 天 |
匿名访问还受共享网络滥用限制，以及每个来源 IP 每天 10,000 条结果行的限额。客户端必须保留服务器签发的会话，才能继续使用会话限额。免费密钥的每日限额为每个账户 10,000 条结果行。两种访问方式使用相同的活动搜索和覆盖范围。
商业产品、批量提取和 REST API 使用需要相应的付费方案。请查看 MCP 页面了解当前限制，并查看服务条款了解允许的用途。试用个人活动搜索无需注册。
Gemini CLI
gemini extensions install https://github.com/isaacaskew/venunite-events
重启 Gemini CLI，然后检查 /mcp 以确认发现结果。此扩展仅启用 search_events，因此所有内置工具均无需凭据即可使用。
此清单遵循 Gemini 扩展格式。它通过 HTTP 连接，不包含可执行钩子或本地服务代码。直接安装不依赖于扩展库列表。
Claude Code
从 VenuNite 的代码库市场安装插件：
claude plugin marketplace add isaacaskew/venunite-events
claude plugin install venunite-events@venunite
或者仅添加托管连接器：
claude mcp add --transport http venunite-events https://mcp.venunite.com/v1/mcp/
请参阅 Claude 市场文档。此代码库市场与在公开 Claude Directory 中获批是两回事。
Claude、Perplexity、Grok、Mistral 和其他远程 MCP 客户端
在客户端的自定义连接器设置中，添加上方的端点，并为活动搜索选择无需身份验证。客户端必须支持 Streamable HTTP。能否使用取决于客户端方案和管理员设置。
自定义安装并不意味着已获批准或已收录在提供商的目录中。
GitHub Copilot / VS Code
将 .mcp.json 中的 mcpServers 条目合并到项目的 .mcp.json。对于 VS Code 配置格式，则将 configs/vscode.json 合并到 .vscode/mcp.json。保留现有的服务条目。使用 VS Code 的 MCP 控件启动服务，并在使用前查看其工具。
Cursor
此仓库包含一个 Cursor 插件清单，位于
.cursor-plugin/plugin.json，可无凭据连接到托管服务。
在 Marketplace 上架需要经过 Cursor 的单独审核；仅有清单并不意味着已上架。
将 configs/cursor.json 合并到项目中的 .cursor/mcp.json，
或合并到用户目录下的 ~/.cursor/mcp.json。保留现有条目。
Windsurf / Devin Desktop Cascade
从 Cascade 的 Actions 菜单打开 MCP 配置文件，然后合并
configs/cascade.json 中的服务条目。当前桌面版
文档将该产品称为 Devin Desktop。在 MCP 控制面板中启用服务并查看工具列表。
工具和可选身份验证
| 工具 | 功能 | 身份验证 |
|---|---|---|
search_events | 按地点、日期和兴趣筛选条件搜索活动信息和来源链接 | 无，但须遵守公平使用限制 |
create_ticket_handoff | 为选定活动创建带归属信息且可安全预览的链接 | VenuNite 有效 API 密钥 |
发现服务器所有工具的客户端都会看到 create_ticket_handoff，但匿名调用会返回 authentication_required。
搜索结果已包含 VenuNite 活动页面（如有票务链接，也会一并提供）。
如需可选的身份验证访问权限，请在
VenuNite 开发者密钥创建自己的密钥，然后配置
客户端的密钥／标头机制，以发送 Authorization: Bearer <key>。
切勿提交真实密钥。Gemini 用户如需使用交接工具，可在自己的设置中添加经身份验证的服务；捆绑扩展不需要密钥。
交接不会购买门票、预留库存，也不保证有票或最终价格。 用户需要查看其页面，并明确选择继续，然后才会跳转至外部票务销售方。 自动化客户端必须将此决定留给用户。
服务端会接收工具参数和连接元数据。调用会记录配额和请求遥测信息。未缓存的具名地点可能会发送至公共 Nominatim 地理编码器。连接器不会请求完整对话历史、本地文件、日历或电子邮件访问权限。
试用
- 查找本周末丹佛市低于 30 美元的现场音乐活动。请附上日期和链接。
- 查找下周末丹佛市的免费社区活动。
- 查找明天博尔德适合家庭参与的活动。
请使用具体城市和日期范围。通过链接的场馆或主办方核实当前活动详情；搜索结果为空表示没有符合条件的活动。
开发
服务运行于 VenuNite 基础设施上；此仓库仅包含配置和文档。使用以下命令验证 Claude 清单：
claude plugin validate .claude-plugin/plugin.json --strict
claude plugin validate .claude-plugin/marketplace.json --strict
配置文件采用 MIT 许可证。托管服务和活动数据仍受 VenuNite 服务条款及原始来源权利的约束。
评论
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。