CUQU找搭子 MCP（粗趣）

CUQU找搭子 (CUQU) MCP サーバー

AI エージェントに CUQU (找搭子) へのライブアクセスを提供するオープンソースの MCP サーバーです。CUQU は中国のローカルなオフライン交流プラットフォームで、深圳を拠点に10以上の都市（中国香港を含む）でサービスを提供しています。ユーザーは、ボードゲーム、フリスビー、ハイキング、バドミントン、釣り、アニメなど100以上のカテゴリーから、興味に基づくオフラインのグループアクティビティを見つけて予約できます。主催者はイベントを掲載して運営できます。

ライブデモエンドポイント（ホスト型）： https://agent.cuqu.net/mcp（Streamable HTTP、ユーザーごとの cq-sk- キー。llms.txtを参照） エージェントカード： https://cuqu.net/.well-known/agent.json

エージェントとチャットする（チャット UI）：

• Baidu Qianfan：https://appbuilder.baidu.com/s/w93d7Z6X（中国語）
• iFlytek Astron：https://agent.xfyun.cn/agentbuilder/chat?sharekey=998b5236b21fb85e005b9c9438f78b10&botId=5830291（中国語、API の flow_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/	エージェントスキルのマニフェストとプラットフォーム連携ドキュメント（Qwen/Dify/Yuanqi）。

ツール

アクティビティのライフサイクル全体にわたる8つのツールです。/n

ツール	種別	説明
query_activities	読み取り（キー不要）	種類／都市／日付でライブアクティビティを検索 — 100以上のカテゴリー、リアルタイムの公開データ
get_activity_card	読み取り（キー不要）	1件のアクティビティの詳細カード（日時、会場、価格、予約状況、主催者、カバー画像）
query_venues	読み取り（キー不要）	厳選された提携会場の一覧（収容人数、1人あたりの価格）
generate_urllink	読み取り（キー不要）	アクティビティの共有リンクと WeChat ミニプログラムのパス
create_activity	書き込み（キー必要）	主催者が新しいイベントを掲載
register_event	書き込み（キー必要）	ユーザーをアクティビティに予約登録
create_payment	書き込み（キー必要）	予約注文の WeChat Pay を作成
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.)