CUQU找搭子 (CUQU) MCP Server

io.github.cuqu-net由 GitHub 账号 cuqu-net 发布v1.0.2更新于 Oct 24, 2026

CUQU找搭子: find & book offline group activities in 10+ China cities; publish your own.

已验证Streamable HTTP可网页运行位置与生活效率与工作流

概览

AI 生成的概览

将助手接入中国线下组局平台 CUQU 找搭子,可搜索和报名活动、发布活动、支付及签到。

可以做什么
按类型、日期、区域或关键词搜索实时活动,获取单个活动的卡片(含分享链接与 H5 页面),为页面或活动生成小程序分享链接,并按类型、区域和容纳人数浏览合作场地。以主理人身份发布新活动,填写标题、类型、日期、时间、地点、人数和价格。为活动报名登记姓名、手机号和备注,返回订单号与支付链接。为报名订单生成微信支付链接和二维码。通过手机号、用户 ID 或签到码在现场完成签到。
适用场景
适合用户想在中国支持的城市查找、比较或报名线下兴趣活动,需要在微信外分享活动链接、寻找合作场地,或通过对话助手发布和管理自己的活动时使用。
运行要求
可通过 Streamable HTTP 连接 agent.cuqu.net 远程端点,或本地运行零依赖的 Python 3.9+ 服务(也支持 Docker)。读取类工具无需密钥;写入类工具需要经扫码签发流程获取的 CUQU_API_KEY(cq-sk-...)。需要能访问 CUQU 的 API。
安装前请注意
写入类工具会发布活动、创建报名与支付并执行签到,需要 CUQU_API_KEY 密钥,应妥善保密。报名需完成支付才能锁定名额,会通过微信支付产生真实费用。报名会把参与者姓名和手机号发送给 CUQU,签到依赖该手机号或签到码匹配。

安装

在 SourceWeft 中

  1. 打开 控制台中的 CUQU找搭子 (CUQU) MCP Server,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.cuqu-net%2Fcuqu-mcp/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "cuqu-cuqu": {
      "type": "http",
      "url": "https://agent.cuqu.net/mcp"
    }
  }
}

README

CUQU找搭子 (CUQU) MCP Server

[smithery badge]

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):

What this repository contains

PathWhat it is
server.pyThe MCP server implementation — zero-dependency Python, JSON-RPC 2.0 over stdio. Read tools call CUQU's public live activity API; write tools forward to the hosted gateway with a user key.
DockerfileOne-command container build for the server (glama.ai / docker / any MCP host).
glama.jsonglama.ai directory metadata & maintainership.
scripts/check-mcp.pyConnectivity check for the hosted gateway.
skills/, docs/Agent skill manifests and platform integration docs (Qwen/Dify/Yuanqi).

Tools

8 tools across the activity lifecycle:/n

ToolTypeDescription
query_activitiesread (no key)Search live activities by type / city / date — 100+ categories, real-time public data
get_activity_cardread (no key)Full detail card for one activity (time, venue, price, booking progress, organizer, cover)
query_venuesread (no key)Curated partner venue directory (capacity, per-head price)
generate_urllinkread (no key)Share link + WeChat mini-program path for an activity
create_activitywrite (key)Organizer publishes a new event
register_eventwrite (key)Book a user into an activity
create_paymentwrite (key)Create WeChat Pay for a booking order
check_inwrite (key)On-site check-in / redemption

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).

Quick start

bash
# stdio, zero dependencies, Python 3.9+python -u server.py
# or via Dockerdocker build -t cuqu-mcp .docker run -i cuqu-mcp

Claude Desktop / any stdio MCP client:

json
{  "mcpServers": {    "cuqu": {      "command": "python",      "args": ["-u", "/path/to/server.py"],      "env": { "CUQU_API_KEY": "cq-sk-...(optional, enables write tools)" }    }  }}

License

MIT — © 2026 光天科技(深圳)有限公司 (Guangtian Technology (Shenzhen) Co., Ltd.)

来源:README.md,提交 aafd348

工具

8

query_activities

查询粗趣小程序上的活动列表。 当用户想找活动、看有什么活动、按条件筛选活动时调用此工具。 Args: activity_type: 活动类型筛选,如"桌游聚会"、"户外徒步"、"剧本杀"、"飞盘"等。留空则不筛选。 date: 日期筛选,格式"2026-08-22"。留空则不筛选。 location: 区域筛选,如"南山区"、"罗湖区"。留空则不筛选。 keyword: 关键词搜索活动标题和描述。留空则不搜索。 Returns: JSON 字符串,包含活动列表(标题、时间、地点、价格、剩余名额、H5 链接等)

输入参数datekeywordlocationactivity_type

create_activity

主理人在粗趣小程序上发布新活动。 当用户(主理人)想创建/发布一个活动时调用此工具。 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 和详情链接

输入参数date必填time必填pricetitle必填location必填organizerdescriptionactivity_type必填max_participants

register_event

用户报名参加活动。 当用户确定要报名某个活动时调用此工具。报名后需要完成支付才能锁定名额。 Args: activity_id: 活动 ID(从 query_activities 结果中获取) user_name: 报名人姓名 phone: 手机号(用于接收活动通知和签到) note: 备注,如饮食禁忌、特殊需求等(可选) Returns: JSON 字符串,包含订单号、支付链接和支付二维码 URL

输入参数notephone必填user_name必填activity_id必填

create_payment

生成活动报名的支付链接和二维码。 报名后通过此工具获取支付链接,用户扫码或点击链接完成微信支付。 Args: order_id: 订单号(优先使用,从 register_event 结果中获取) activity_id: 活动 ID(无订单号时配合手机号使用) phone: 手机号(配合活动 ID 查找订单) Returns: JSON 字符串,包含支付链接、二维码 URL、支付方式和有效期

输入参数phoneorder_idactivity_id

check_in

活动签到。 用户到达活动现场后,通过此工具完成签到。支持手机号/用户ID/签到码三种方式。 Args: activity_id: 活动 ID phone: 手机号(用于签到,需与报名时一致) user_id: 用户 ID(已登录用户) code: 签到码(现场扫码获取,或主理人提供的签到口令) Returns: JSON 字符串,包含签到状态和签到时间

输入参数codephoneuser_idactivity_id必填

query_venues

查询粗趣小程序合作场地列表。 当用户需要找场地、了解场地信息时调用此工具。 Args: venue_type: 场地类型,如"桌游吧"、"运动场地"、"露营基地"等。留空则不筛选。 location: 区域,如"南山区"、"罗湖区"。留空则不筛选。 min_capacity: 最少容纳人数,整数或数字字符串均可,如 10 或 "10"。填0则不筛选。 Returns: JSON 字符串,包含场地列表(名称、类型、位置、容量、价格区间、设施等)

输入参数locationvenue_typemin_capacity

get_activity_card

获取活动的"卡片"数据(C 端工具包核心)。 当用户想直接看到某活动的小程序卡片(标题 + 封面 + 时间地点 + 价格 + 报名链接) 时调用此工具。返回的卡片包含: - url_link: 小程序 URL Link(微信外点击唤起小程序活动页) - h5_url: H5 活动页地址(AI 应用内直接打开) Args: activity_id: 活动 ID Returns: JSON 字符串,包含活动卡片数据

输入参数activity_id必填

版本历史

2
  1. v1.0.2最新Oct 3, 2026
  2. v1.0.0Sep 28, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分