CUQU找搭子 (CUQU) MCP Server
CUQU找搭子: find & book offline group activities in 10+ China cities; publish your own.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http cuqu-cuqu-mcp-server 'https://agent.cuqu.net/mcp'{
"mcpServers": {
"cuqu-cuqu-mcp-server": {
"type": "http",
"url": "https://agent.cuqu.net/mcp"
}
}
}Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
CUQU找搭子 (CUQU) MCP Server
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):
- Baidu Qianfan: https://appbuilder.baidu.com/s/w93d7Z6X (Chinese)
- iFlytek Astron: https://agent.xfyun.cn/agentbuilder/chat?sharekey=998b5236b21fb85e005b9c9438f78b10&botId=5830291 (Chinese; API flow_id
7510896245077958656) - Live weekly activities: https://cuqu.net/activities/list/ (real in-stock data, updated daily)
- IRL Activity Schema v0.1 (CC BY 4.0): https://cuqu.net/schema/irl-activity/v0.1/irl-activity-schema.json
What this repository contains
| Path | What it is |
|---|---|
server.py | The 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. |
Dockerfile | One-command container build for the server (glama.ai / docker / any MCP host). |
glama.json | glama.ai directory metadata & maintainership. |
scripts/check-mcp.py | Connectivity 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
| Tool | Type | Description |
|---|---|---|
query_activities | read (no key) | Search live activities by type / city / date — 100+ categories, real-time public data |
get_activity_card | read (no key) | Full detail card for one activity (time, venue, price, booking progress, organizer, cover) |
query_venues | read (no key) | Curated partner venue directory (capacity, per-head price) |
generate_urllink | read (no key) | Share link + WeChat mini-program path for an activity |
create_activity | write (key) | Organizer publishes a new event |
register_event | write (key) | Book a user into an activity |
create_payment | write (key) | Create WeChat Pay for a booking order |
check_in | write (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
# stdio, zero dependencies, Python 3.9+
python -u server.py
# or via Docker
docker build -t cuqu-mcp .
docker run -i cuqu-mcpClaude Desktop / any stdio MCP client:
{
"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.)
Questions fréquentes
Qu'est-ce que CUQU找搭子 (CUQU) MCP Server ?
CUQU找搭子: find & book offline group activities in 10+ China cities; publish your own.
Comment installer CUQU找搭子 (CUQU) MCP Server ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http cuqu-cuqu-mcp-server 'https://agent.cuqu.net/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour CUQU找搭子 (CUQU) MCP Server ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
CUQU找搭子 (CUQU) MCP Server est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient CUQU找搭子 (CUQU) MCP Server ?
Il est publié par cuqu-net. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.