Meetup

@pipeworx/meetup

Meetup 活动和群组搜索 MCP——搜索 Meetup 上的公开活动、群组和主题类别，可按关键词、城市或群组搜索。无需密钥。

属于 Pipeworx——一个将 AI Agent 连接到 1807+ 个实时数据源的 MCP 网关。这是独立的非官方集成，与上游提供方无关联，也未获其认可或发布。

工具

• meetup_search_events(query, city?, lat?, lon?, radius?, limit?) — 按关键词搜索城市附近（自动进行地理编码）或指定经纬度周边即将举行的公开活动。返回每场活动的标题、时间、URL、状态、类型和主办群组。
• meetup_event(event_id) — 根据 Meetup 数字 ID（meetup.com 活动 URL 末尾的数字）获取单场活动的完整详情。返回标题、描述、开始和结束时间、状态、类型、场地和主办群组。
• meetup_group(urlname) — 根据 urlname 获取单个群组的详情（即 meetup.com/ 后面的 slug，例如 “sfpython”）。返回名称、描述、位置、时区、主题类别和成立日期。
• meetup_group_events(urlname, limit?, include_past?) — 根据 urlname 获取群组的活动；默认返回即将举行的活动，设置 include_past: true 则返回过去的活动。

这些工具都不会请求或返回参加者/RSVP 列表、成员列表或任何其他个人联系信息——这是刻意为之，并非疏漏（见下文“隐私”）。

身份验证

无需密钥。无需密钥或账户，也未发布速率限制文档。

数据来源

• Meetup（meetup.com），其自有网站搜索和活动/群组页面背后的公开 GraphQL API——提供活动、群组和主题类别元数据。除此之外没有指定下载文件、信息源或查询结构；路由请参见 src/index.ts。

隐私

Meetup 的架构会在 Event/Group 中公开参加者 RSVP、主办方身份和成员列表。本工具包中的任何查询都不会选择这些字段——此处的每个查询都仅限于公开的活动/群组元数据（标题、时间、场地、描述、位置），不包含其他内容。请保持如此：重新阅读本说明前，不要在任何查询中添加 rsvps、hostRsvps、memberships、organizer、eventHosts 或 savedBy。

注意事项

• lat/lon 是上游 API 本身要求的参数，并非本工具包自行决定——EventSearchFilter/GroupSearchFilter 都将它们声明为非空。调用 Meetup 前，meetup_search_events 会通过共享的 resolvePlace 地理编码服务（@pipeworx/shared，由 Open-Meteo 提供支持，无需密钥）将 city 字符串解析为坐标，因此调用方无需提供原始坐标；但如果地理编码无法解析城市，工具会明确报错，而不会猜测。
• **radius 的单位是英里。**上游筛选字段是没有注明单位的裸 Float；已通过美国已知城市的半径进行实际验证。
• 活动和群组 ID 是不透明字符串，并非在所有情况下都呈现为数字——event_id 是 meetup.com/{group-urlname}/events/{event-id}/ URL 的末尾路径段，群组的 urlname 则是 meetup.com/ 后面的 slug。两者无法互相推导，必须查询；meetup_search_events 和 meetup_group_events 会提供这两项信息。
• meetup_group_events 在没有活动安排时会返回 total_count: 0，而不是错误——真实且活跃但暂时没有活动的群组（已对 sfpython 进行在线验证），仅从响应结构来看，与已失效/错误的 urlname 完全相同；只有 meetup_group 因 urlname 本身报错，才能区分“群组不存在”和“当前没有活动”。
• GraphQL 错误会以 HTTP 200 返回，并包含顶层 errors 数组（这是 GraphQL 的标准行为）——本工具包会明确检查 errors，而不是只信任 res.ok，因为查询格式错误或 ID 无效都会返回 200。

快速开始

将其添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "meetup": {
      "url": "https://gateway.pipeworx.io/meetup/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/meetup/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、 discover_tools、search_within、remember/recall 和其余适用于整个网关的工具。因此，你看到的工具数量会多于此表：单个工具包端点目前会列出大约 30 个共享工具，以及该工具包自身的工具。连接的 initialize 响应会说明确切范围，也是当天情况的权威说明。

这是有意为之，并非意外地进行了多路复用。元工具能让限定范围的连接回答此工具包无法涵盖的问题——通过 ask_pipeworx 跨整个目录进行路由——无需额外添加第二个 MCP 服务。目前无法挂载不含这些元工具的工具包端点；如果额外的架构信息占用的上下文比路由带来的价值更多，请改为连接一次完整网关，而不是连接多个工具包端点。

或者连接完整的 Pipeworx 网关，直接列出所有工具包的工具，而不只是当前工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

这两个 URL 都连接到同一个网关和同样的 1807+ 个数据源。唯一的区别是直接列出哪个工具包的工具；通过任一 URL，ask_pipeworx 都能访问所有工具包。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/meetup_search_events \
  -H 'Content-Type: application/json' \
  -d '{"query":"music","lat":40.71,"lon":-74,"radius":20,"limit":5}'

首次调用无需账号。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/meetup_search_events。查找工具包：使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。

独立运行（无需网关账号）

此软件包也可作为本地 stdio MCP 服务运行——无需 Pipeworx 账号，也无需经由网关往返：

{
  "mcpServers": {
    "meetup": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-meetup"]
    }
  }
}

或者直接运行，确认它能正常启动：

npx -y @pipeworx/mcp-meetup

它通过 stdin/stdout 使用 MCP，并为仅此工具包的工具响应 initialize/tools/list/tools/call——不包含上方网关连接所添加的任何共享元工具。使用相同源码和工具，但不支持 ask_pipeworx 路由。

使用 ask_pipeworx

你可以不直接调用工具，而是用通俗的英语提问——这既适用于上方的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Meetup data" })

网关会自动选择合适的工具并填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT