WCS Points

WSDC ポイント MCP サーバー

West Coast Swing のダンサーの WSDC ポイント、ディビジョン、レベルアップ、競技会の結果について、Claude、ChatGPT、Cursor、または任意の AI アシスタントに質問できます。 World Swing Dance Council（WSDC）ポイントレジストリ向けの、無料で一般公開されている読み取り専用の Model Context Protocol（MCP）サーバーです。約27,000人のダンサーと約8,000件のイベントを収録しています。

• エンドポイント： https://wcspoints.com/mcp（Streamable HTTP、API キー不要、登録不要）
• ウェブサイト： wcspoints.com · llms.txt · サーバーカード
• 公式 MCP レジストリ名： com.wcspoints/wsdc-points

非公式プロジェクトであり、World Swing Dance Council とは提携していません。公式レジストリは worldsdc.com/registry です。

質問できること

• 「フォロワーとして出場できるディビジョンは何ですか？ 名前は……です」
• 「アップするには、中級のポイントがあといくつ必要ですか？ WSDC ID は……です」
• 「直近の Swing Diego のチャンピオンズの結果を見せてください」
• 「過去3か月で、ドイツでオールスターにレベルアップしたのは誰ですか？」
• 「フランスには、現在活動中のアドバンストのリーダーが何人いますか？」
• 「フォロワー45人のノービス・ジャック＆ジルで、1位は何ポイント獲得しますか？」

接続

クライアント	方法
Claude（claude.ai、デスクトップ）	設定 → コネクター → カスタムコネクターを追加 → URL https://wcspoints.com/mcp
Claude Code	claude mcp add --transport http wsdc-points https://wcspoints.com/mcp
ChatGPT	アプリ／コネクターの開発者モードを有効にし、上記の URL を使って認証なしのコネクターを作成します
Cursor / Windsurf	{"mcpServers": {"wsdc-points": {"url": "https://wcspoints.com/mcp"}}}
VS Code (Copilot)	.vscode/mcp.json: {"servers": {"wsdc-points": {"type": "http", "url": "https://wcspoints.com/mcp"}}}
その他	Streamable HTTP トランスポートに対応した任意の MCP クライアント

ツール

すべてのツールは読み取り専用（readOnlyHint: true）で、出力スキーマに従った構造化 JSON を返します。

ツール	機能
search_dancers	名前（順不同、一部のみ、誤記、キリル文字）または WSDC ID でダンサーを検索します
get_dancer_profile	現在のディビジョンと役割ごとのポイント（Leader/Follower）、役割ごとに参加可能な Jack & Jill のディビジョン、ディビジョンごとのポイント、レベルアップの履歴
get_dancer_results	ダンサーの順位：イベント、日付、ディビジョン、役割、順位、ポイント。ディビジョン、役割、年で絞り込めます
search_events	WSDC 登録イベントを名前、都市、年、国で検索します
get_event_results	1 つのイベントの Jack & Jill 全順位をディビジョンごとに取得します
get_jj_partners	ダンサーが Jack & Jill の決勝に進出した相手：パートナーと組んだ各順位と、最も多く組んだパートナー
get_event_history	イベントシリーズの全開催回（例：各年の US Open）と、ディビジョンごとの優勝者または上位入賞者
get_registry_updates	直近数日間に登録簿へ結果が公開されたイベントと、最上位ディビジョンの優勝者
get_recent_levelups	最近ディビジョンが上がったダンサーを国とディビジョンごとに取得します
get_division_stats	世界全体または国ごとの、現在のディビジョンと役割別のダンサー数
search_wsdc_rules	現行の WSDC 登録イベント規則を検索します（昇格基準、ティアごとのポイント、セカンダリー役割のルールなど）
get_registry_info	データの対象範囲と鮮度

リソース：wsdc://rules/current。現行ルールブックの全文です。

プロンプト（対応クライアントではスラッシュコマンドとして表示）：divisions_check（ダンサーが参加できるディビジョン）、dancer_story、event_story（イベントの歴代優勝者）、registry_news、rules_question。引数の dancer、event、country、division は登録簿から補完されます（completion/complete）。

インタラクティブカード（MCP Apps）：この拡張機能に対応したホストでは、get_dancer_profile が ui://wsdc/dancer-card.html をレンダリングします。カードには、役割ごとのディビジョン、ディビジョンごとのポイント、レベルアップが表示され、ダンサーの順位や決勝のパートナーを問い合わせるボタンもあります。それ以外のクライアントでは、従来と同じ構造化された結果が返されます。

仕組み

• データは、公開 WSDC ポイント登録簿（@wsdc_bot Telegram ボットの背後にあるものと同じデータベース）の継続的に同期されるミラーから取得されます。
• 主要／セカンダリー役割のルールを含む、役割ごとのディビジョン参加資格はデータベースで計算され、そのまま返されるため、サーバーとボットの結果は常に一致します。
• ステートレスな Streamable HTTP（JSON レスポンス）、数分間の結果キャッシュ、IP ごとのレート制限を使用します。
• Python 3.12、MCP Python SDK v2、psycopg 3、Starlette。

開発

python3.12 -m venv venv && venv/bin/pip install -r requirements-dev.txt
venv/bin/python -m pytest -q                       # unit tests (no database needed)
WSDC_MCP_TEST_DSN="dbname=wsdc host=127.0.0.1" venv/bin/python -m pytest -q   # + end-to-end tests
WSDC_MCP_DB_DSN="dbname=wsdc host=127.0.0.1" venv/bin/python -m wsdc_mcp      # serve on 127.0.0.1:8001

変数	意味
WSDC_MCP_DB_DSN	WSDC 登録簿データベースの PostgreSQL DSN（読み取り専用ロール）
WSDC_MCP_PUBLIC_URL	リンクとディスカバリードキュメントで使用する公開オリジン（デフォルト https://wcspoints.com）
WSDC_MCP_HOST / WSDC_MCP_PORT	バインドアドレス（デフォルト 127.0.0.1:8001）
WSDC_MCP_RULES_PATH	プレーンテキストの WSDC ルールブック。設定すると search_wsdc_rules が有効になります
WSDC_MCP_POOL_MAX, WSDC_MCP_STATEMENT_TIMEOUT_MS	DB プールサイズ（3）とクエリごとのタイムアウト（8000 ms）
WSDC_MCP_USAGE_LOG	利用ログのファイル：MCP リクエストごとに 1 行の JSON（メソッド、ツール、見つかった結果、クライアントアプリ、ステータス）を記録し、毎日ローテーションして 30 日間保持します。未設定の場合、各行はプロセスログに出力されます

サーバーは WSDC パーサープロジェクトの登録簿スキーマ（contester_view、contester_view_roles、entry_view、event など）を想定しています。コードは透明性と再利用のために公開されています。

プライバシー

アカウント、Cookie、トラッカーは使用しません。wcspoints.com のホストサーバーでは、リクエストとツール呼び出し（送信元の AI アプリ名を含む）を記録し、利用統計のために保存します。 結果には、WSDC が公開レジストリで公開している情報のみが含まれます。詳しくは wcspoints.com/privacy をご覧ください。

ライセンス

MIT