CUQU找搭子 (CUQU) MCP Server
CUQU找搭子: find & book offline group activities in 10+ China cities; publish your own.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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"
}
}
}التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على 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.)
الأسئلة الشائعة
ما هو CUQU找搭子 (CUQU) MCP Server؟
CUQU找搭子: find & book offline group activities in 10+ China cities; publish your own.
كيف أثبّت CUQU找搭子 (CUQU) MCP Server؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http cuqu-cuqu-mcp-server 'https://agent.cuqu.net/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج CUQU找搭子 (CUQU) MCP Server إلى مفتاح API؟
لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.
هل CUQU找搭子 (CUQU) MCP Server مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون CUQU找搭子 (CUQU) MCP Server؟
ينشره cuqu-net. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.