Chess.com Mcp (interactive Views)

一个用于展示如何构建带交互式 React 视图的 MCP 应用的参考示例——每个工具都附带自己的视图，而不是返回纯文本。它使用 Skybridge 构建，可查询 Chess.com 上的棋手、对局和每日谜题，并可在 ChatGPT 和 Claude 中运行。

试用

• 在线演示： chess.niklas.sh
• MCP 服务 URL： https://mcp.chess.niklas.sh/mcp

只需将 MCP 服务 URL 添加到任何兼容的客户端（ChatGPT、Claude 等）即可。然后可以提出诸如 “显示 magnuscarlsen 的上一场对局” 或 “给我今天的国际象棋谜题” 之类的问题。

工具

工具	输入	描述
get-chess-player	username	棋手资料，包含快棋、闪电战和子弹棋评级，以及胜／负／和记录。
get-last-game	username	棋手最近的一场对局——结果、对手、开局，以及可交互的棋盘回放。
get-daily-puzzle	无	Chess.com 的每日谜题，以交互式棋盘呈现：逐步走棋并即时查看反馈、揭晓解法，或重置后重试。

入门

前置条件

• Node.js 24.14.1+
• pnpm 9+

安装

pnpm install

启动开发服务

pnpm dev

这会启动：

• 位于 http://localhost:3000/mcp 的 MCP 服务。
• 位于 http://localhost:3000 的 Skybridge DevTools UI。

所有脚本（dev、build、test、lint、typecheck）均定义在 package.json 中。

项目结构

├── src/
│   ├── server.ts         # Server entry: tool definitions + analytics middleware
│   ├── chess-com.ts      # Typed Chess.com API client (zod boundary + helpers)
│   ├── analytics.ts      # PostHog wrapper (no-op without a key)
│   ├── helpers.ts        # Typed useToolInfo / useCallTool hooks
│   ├── views/            # One React view per tool
│   │   └── shared/       # Shared view code (chess board, helpers)
│   └── index.css         # Global styles
├── vite.config.ts        # Vite + Skybridge + Tailwind config
├── Dockerfile            # Cloud Run image
└── package.json

测试

运行 pnpm dev 时，可通过 http://localhost:3000 的 DevTools UI 在本地测试应用。

单元测试使用 Vitest 运行：pnpm test。

要连接 ChatGPT 或 Claude 等 Web 客户端，请使用 --tunnel 标志公开服务（pnpm dev:tunnel）。参见测试指南。

部署与分析

此应用通过 release-please 部署到 Google Cloud Run，并可使用 PostHog 跟踪工具调用（除非配置，否则不执行任何操作）。完整设置请参见 docs/deployment.md。

资源

• Skybridge 文档
• Apps SDK 文档
• MCP Apps 文档
• Model Context Protocol 文档

许可证

源代码依据 Beerware 许可证发布。

棋子图标来自 Flaticon 的 “Chess” 素材包，并依据 Flaticon Free License 使用——这些图标不受 Beerware 许可证约束。详情请参见 NOTICE。