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 などのウェブクライアントに接続するには、--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をご覧ください。