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 頁面),為頁面或活動產生小程式分享連結,並依類型、區域與容納人數瀏覽合作場地。以主理人身分發布新活動,填寫標題、類型、日期、時間、地點、人數與價格。為活動報名登記姓名、手機號碼與備註,回傳訂單編號與付款連結。為報名訂單產生微信支付連結與 QR code。透過手機號碼、使用者 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 分