CUQU找搭子 MCP（粗趣）

CUQU找搭子（CUQU）MCP 服务

开源 MCP 服务，让 AI Agent 实时访问 CUQU（找搭子）——一个位于中国的本地线下社交活动平台（总部位于深圳，覆盖 10 多个城市，包括中国香港）。用户可以发现并预订基于兴趣的线下团体活动（桌游、飞盘、徒步、羽毛球、钓鱼、动漫及其他 100 多个类别）；组织者可以发布和举办活动。

在线演示端点（托管）： https://agent.cuqu.net/mcp（Streamable HTTP，用户专属 cq-sk- 密钥——参见 llms.txt） Agent 卡片： https://cuqu.net/.well-known/agent.json

与 Agent 对话（聊天界面）：

• 百度千帆：https://appbuilder.baidu.com/s/w93d7Z6X（中文）
• 讯飞 Astron：https://agent.xfyun.cn/agentbuilder/chat?sharekey=998b5236b21fb85e005b9c9438f78b10&botId=5830291（中文；API 流程 ID 为 7510896245077958656）
• 每周实时活动：https://cuqu.net/activities/list/（真实库存数据，每日更新）
• IRL Activity Schema v0.1（CC BY 4.0）：https://cuqu.net/schema/irl-activity/v0.1/irl-activity-schema.json

此仓库包含的内容

路径	内容
server.py	MCP 服务实现——零依赖 Python，通过 stdio 使用 JSON-RPC 2.0。读取工具调用 CUQU 的公开实时活动 API；写入工具将请求转发到托管网关，并使用用户密钥。
Dockerfile	一条命令即可为该服务构建容器（glama.ai / docker / 任意 MCP 主机）。
glama.json	glama.ai 目录元数据和维护信息。
scripts/check-mcp.py	托管网关的连接检查。
skills/、docs/	Agent 技能清单和平台集成文档（Qwen/Dify/Yuanqi）。

工具

覆盖活动全流程的 8 个工具：/n

工具	类型	描述
query_activities	读取（无需密钥）	按类型 / 城市 / 日期搜索实时活动——100 多个类别，实时公开数据
get_activity_card	读取（无需密钥）	单场活动的完整详情卡片（时间、场地、价格、预订进度、组织者、封面）
query_venues	读取（无需密钥）	精选合作场地目录（容量、人均价格）
generate_urllink	读取（无需密钥）	活动分享链接和微信小程序路径
create_activity	写入（需要密钥）	组织者发布新活动
register_event	写入（需要密钥）	为用户预订活动
create_payment	写入（需要密钥）	为预订订单创建微信支付
check_in	写入（需要密钥）	现场签到 / 核销

写入工具由托管网关执行，需要 CUQU_API_KEY（cq-sk-...，通过 llms.txt 中说明的扫码签发流程获取）。

快速开始

# stdio, zero dependencies, Python 3.9+
python -u server.py

# or via Docker
docker build -t cuqu-mcp .
docker run -i cuqu-mcp

Claude Desktop / 任意 stdio MCP 客户端：

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

许可证

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