Chess.com MCP Server

Chess.com MCP サーバー

Chess.com の公開 API 向けに TypeScript で記述されたモデルコンテキストプロトコルサーバーです。認証なしで、Chess.com PubAPI のドキュメントに記載されたすべての機能を、30 個のツールと 7 個のリソースを通じて提供します。

npm からインストール

要件：Node.js 20.9 以降。

公開されている最新パッケージを直接実行します：

npx -y chess-mcp-node@latest

デフォルトのトランスポートは stdio です。このパッケージは npm で配布されており、レジストリのメタデータ公開後は VS Code の MCP ギャラリーからもインストールできます。

VS Code の場合、ワークスペースに .vscode/mcp.json を作成するか、開いてください：

{
  "servers": {
    "chess": {
      "command": "npx",
      "args": ["-y", "chess-mcp-node@latest"]
    }
  }
}

公開後、VS Code で @mcp chess を検索し、インストールを選択すると、MCP ギャラリーからサーバーを追加できます。

Claude Desktop の場合、MCP 設定にサーバーを追加してください：

{
  "mcpServers": {
    "chess": {
      "command": "npx",
      "args": ["-y", "chess-mcp-node@latest"]
    }
  }
}

ソースから実行

要件：Node.js 20.9 以降。

npm ci
npm run build
npm start

ソースから実行する場合のデフォルトのトランスポートは stdio です。オプションの SSE トランスポートを実行するには：

# macOS/Linux
MCP_TRANSPORT=sse npm start

# Windows PowerShell
$env:MCP_TRANSPORT = "sse"
npm start

SSE サーバーはデフォルトでポート 8000 をリッスンし、/sse、/messages、/health を提供します。デフォルト値を変更するには、PORT と HOST を設定してください。

開発またはテスト用に Chess.com API のベース URL を変更するには、CHESS_API_BASE_URL を設定してください。

開発

テストスイートと型チェッカーを実行します：

npm test
npm run typecheck

カバレッジレポートを作成します：

npm run test:coverage

利用可能なツール

• get_player_profile
• get_titled_players
• get_player_stats
• is_player_online
• get_player_current_games
• get_player_games_to_move
• get_player_game_archives
• get_player_games_by_month
• get_player_live_games
• download_player_games_pgn
• get_player_clubs
• get_player_matches
• get_player_tournaments
• get_club_profile
• get_club_members
• get_club_matches
• get_tournament
• get_tournament_round
• get_tournament_round_group
• get_team_match
• get_team_match_board
• get_live_team_match
• get_live_team_match_board
• get_country_profile
• get_country_players
• get_country_clubs
• get_daily_puzzle
• get_random_puzzle
• get_streamers
• get_leaderboards

利用可能なリソース

• chess://player/{username}
• chess://player/{username}/stats
• chess://player/{username}/games/current
• chess://player/{username}/games/{year}/{month}
• chess://player/{username}/games/{year}/{month}/pgn
• chess://titled/{title}
• chess://club/{url_id}

ライセンス

MIT