io.github.cuqu-netPublished by GitHub account cuqu-netv1.0.2Updated Oct 24, 2026
CUQU找搭子: find & book offline group activities in 10+ China cities; publish your own.
Connects an assistant to CUQU, a Chinese offline group-activity platform, to search and book activities, publish events, pay and check in.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.cuqu-net%2Fcuqu-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"cuqu-cuqu": {
"type": "http",
"url": "https://agent.cuqu.net/mcp"
}
}
}Open-source MCP server giving AI agents live access to CUQU (找搭子) — a local offline social activities platform in China (Shenzhen-based, 10+ cities incl. Hong Kong, China). Users discover and book offline interest-based group activities (board games, frisbee, hiking, badminton, fishing, anime and 100+ more categories); organizers publish and run events.
Live demo endpoint (hosted): https://agent.cuqu.net/mcp (Streamable HTTP, per-user cq-sk- keys — see llms.txt)
Agent Card: https://cuqu.net/.well-known/agent.json
Talk to the agents (chat UI):
7510896245077958656)8 tools across the activity lifecycle:/n
Write tools are executed by the hosted gateway and require CUQU_API_KEY (cq-sk-..., issued via scan-to-issue flow documented in llms.txt).
Claude Desktop / any stdio MCP client:
MIT — © 2026 光天科技（深圳）有限公司 (Guangtian Technology (Shenzhen) Co., Ltd.)
Source: README.md at commit aafd348
查询粗趣小程序上的活动列表。 当用户想找活动、看有什么活动、按条件筛选活动时调用此工具。 Args: activity_type: 活动类型筛选，如"桌游聚会"、"户外徒步"、"剧本杀"、"飞盘"等。留空则不筛选。 date: 日期筛选，格式"2026-08-22"。留空则不筛选。 location: 区域筛选，如"南山区"、"罗湖区"。留空则不筛选。 keyword: 关键词搜索活动标题和描述。留空则不搜索。 Returns: JSON 字符串，包含活动列表（标题、时间、地点、价格、剩余名额、H5 链接等）
datekeywordlocationactivity_type主理人在粗趣小程序上发布新活动。 当用户（主理人）想创建/发布一个活动时调用此工具。 Args: title: 活动标题，如"周六桌游聚会" activity_type: 活动类型，如"桌游聚会"、"户外徒步"、"剧本杀/密室"等 date: 活动日期，格式"2026-08-22" time: 活动时间段，如"14:00-18:00" location: 活动地点，如"南山区·科兴科学园" max_participants: 最大参与人数，数字字符串或整数均可，如 "15" 或 15 price: 人均费用（元），数字字符串或整数均可，如 "39" 或 39，免费填 "0" 或 0 description: 活动描述和注意事项 organizer: 主理人名称 Returns: JSON 字符串，包含活动 ID 和详情链接
daterequiredtimerequiredpricetitlerequiredlocationrequiredorganizerdescriptionactivity_typerequiredmax_participants用户报名参加活动。 当用户确定要报名某个活动时调用此工具。报名后需要完成支付才能锁定名额。 Args: activity_id: 活动 ID（从 query_activities 结果中获取） user_name: 报名人姓名 phone: 手机号（用于接收活动通知和签到） note: 备注，如饮食禁忌、特殊需求等（可选） Returns: JSON 字符串，包含订单号、支付链接和支付二维码 URL
notephonerequireduser_namerequiredactivity_idrequired生成活动报名的支付链接和二维码。 报名后通过此工具获取支付链接，用户扫码或点击链接完成微信支付。 Args: order_id: 订单号（优先使用，从 register_event 结果中获取） activity_id: 活动 ID（无订单号时配合手机号使用） phone: 手机号（配合活动 ID 查找订单） Returns: JSON 字符串，包含支付链接、二维码 URL、支付方式和有效期
phoneorder_idactivity_id活动签到。 用户到达活动现场后，通过此工具完成签到。支持手机号/用户ID/签到码三种方式。 Args: activity_id: 活动 ID phone: 手机号（用于签到，需与报名时一致） user_id: 用户 ID（已登录用户） code: 签到码（现场扫码获取，或主理人提供的签到口令） Returns: JSON 字符串，包含签到状态和签到时间
codephoneuser_idactivity_idrequired查询粗趣小程序合作场地列表。 当用户需要找场地、了解场地信息时调用此工具。 Args: venue_type: 场地类型，如"桌游吧"、"运动场地"、"露营基地"等。留空则不筛选。 location: 区域，如"南山区"、"罗湖区"。留空则不筛选。 min_capacity: 最少容纳人数，整数或数字字符串均可，如 10 或 "10"。填0则不筛选。 Returns: JSON 字符串，包含场地列表（名称、类型、位置、容量、价格区间、设施等）
locationvenue_typemin_capacity为小程序页面生成 URL Link（微信外可打开的标准链接）。 用户想获得某个页面（通常是活动详情页）的可分享链接时调用。 生成的 https://wxaurl.cn/ 链接可在短信、邮件、网页、AI 应用等微信外场景打开， 点击后唤起微信小程序对应页面。 Args: activity_id: 活动 ID。提供时自动映射到活动详情页（path=pages/activity/detail, query=id=xxx）。 path: 小程序页面路径，如 "pages/index/index"。提供 activity_id 时忽略。 query: 页面参数（urlencode 后的字符串），如 "id=act_001"。提供 activity_id 时忽略。 Returns: JSON 字符串，包含 URL Link、页面路径和参数
pathqueryactivity_id获取活动的"卡片"数据（C 端工具包核心）。 当用户想直接看到某活动的小程序卡片（标题 + 封面 + 时间地点 + 价格 + 报名链接） 时调用此工具。返回的卡片包含： - url_link: 小程序 URL Link（微信外点击唤起小程序活动页） - h5_url: H5 活动页地址（AI 应用内直接打开） Args: activity_id: 活动 ID Returns: JSON 字符串，包含活动卡片数据
activity_idrequired100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
# stdio, zero dependencies, Python 3.9+python -u server.py
# or via Dockerdocker build -t cuqu-mcp .docker run -i cuqu-mcp{ "mcpServers": { "cuqu": { "command": "python", "args": ["-u", "/path/to/server.py"], "env": { "CUQU_API_KEY": "cq-sk-...(optional, enables write tools)" } } }}