WCS Points

WSDC 积分 MCP 服务

向 Claude、ChatGPT、Cursor 或任何 AI 助手询问西海岸摇摆舞舞者的 WSDC 积分、 组别、晋级情况和比赛结果。 这是一个免费、公开、只读的 模型上下文协议（MCP）服务，面向 世界摇摆舞理事会（WSDC）积分注册库：约 27,000 名舞者和约 8,000 场赛事。

• 端点： https://wcspoints.com/mcp（Streamable HTTP，无需 API 密钥，无需注册）
• 网站： wcspoints.com · llms.txt · 服务卡片
• 官方 MCP 注册表名称： com.wcspoints/wsdc-points

非官方项目，与世界摇摆舞理事会无关。官方注册表位于 worldsdc.com/registry。

你可以询问

• “作为跟随者，我可以参加哪些组别？我的名字是……”
• “我还需要多少个中级组积分才能晋级？我的 WSDC ID 是……”
• “展示最近一届 Swing Diego 的冠军组结果。”
• “过去 3 个月，德国有哪些舞者晋级了全明星组？”
• “法国有多少名活跃的高级组领舞者？”
• “在有 45 名跟随者的新手组 Jack & Jill 比赛中，第一名能获得多少积分？”

连接

客户端	操作方法
Claude（claude.ai、桌面版）	Settings → Connectors → Add custom connector → 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	单场赛事各组别的所有 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 请求记录一行 JSON（方法、工具、找到的结果、客户端应用、状态），每天轮换并保留 30 天。未设置时，日志行会写入进程日志

服务器需要使用 WSDC 解析器项目的注册表架构（contester_view、contester_view_roles、entry_view、event 等）；公开代码旨在提高透明度并供他人复用。

隐私

无需账户、Cookie 或跟踪器。托管在 wcspoints.com 的服务会记录请求和工具调用 （包括发送请求的 AI 应用名称），并保留这些记录用于统计使用情况。 结果仅包含 WSDC 在其公共注册表中发布的内容。请参阅 wcspoints.com/privacy。

许可证

MIT