Chess.com MCP サーバー

Chess.com の Published Data API 用のModel Context Protocol (MCP) サーバー。

これにより、標準化された MCP インターフェースを通じて Chess.com のプレイヤーデータ、ゲーム記録、その他の公開情報にアクセスできるようになり、AI アシスタントがチェス情報を検索および分析できるようになります。

https://github.com/user-attachments/assets/3b33361b-b604-465c-9f6a-3699b6907757

特徴

• [x] プレイヤーのプロフィール、統計、ゲーム記録にアクセスする

• [x] 日付とプレイヤーでゲームを検索

• [x] プレイヤーのオンラインステータスを確認する

• [x] クラブやタイトル獲得選手の情報を取得する

• [x] 認証は不要（Chess.comのパブリックAPIを使用）

• [x] Dockerコンテナ化のサポート

• [x] AIアシスタントのためのインタラクティブツールを提供する

ツールのリストは構成可能なので、MCP クライアントで使用できるようにするツールを選択できます。

Related MCP server: Chess.com MCP Server

使用法

Docker（推奨）

Claude Desktopでchess-mcpを実行する最も簡単な方法は、Dockerを使うことです。Dockerがインストールされていない場合は、 Dockerの公式サイトから入手できます。

Claude Desktop の設定ファイルを編集します。

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%/Claude/claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

次に、次の構成を追加します。

{
  "mcpServers": {
    "chess": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "pab1it0/chess-mcp"
      ]
    }
  }
}

UVランニング

あるいは、UVを使ってサーバーを直接実行することもできます。Claude Desktopの設定ファイル（上記の場所）を編集し、サーバー設定を追加します。

{
  "mcpServers": {
    "chess": {
      "command": "uv",
      "args": [
        "--directory",
        "<full path to chess-mcp directory>",
        "run",
        "src/chess_mcp/main.py"
      ]
    }
  }
}

注意: Claude DesktopでError: spawn uv ENOENT表示される場合は、 uvへのフルパスを指定するか、構成で環境変数NO_UV=1を設定する必要があります。

発達

貢献を歓迎します！ご提案や改善点がありましたら、問題を報告するか、プルリクエストを送信してください。

このプロジェクトは依存関係の管理にuvを使用しています。お使いのプラットフォームの手順に従ってuvをインストールしてください。

curl -LsSf https://astral.sh/uv/install.sh | sh

次に、次のコマンドで仮想環境を作成し、依存関係をインストールします。

uv venv
source .venv/bin/activate  # On Unix/macOS
.venv\Scripts\activate     # On Windows
uv pip install -e .

テスト

このプロジェクトには、機能性を保証し、回帰を防ぐのに役立つテスト スイートが含まれています。

pytest でテストを実行します。

# Install development dependencies
uv pip install -e ".[dev]"

# Run the tests
pytest

# Run with coverage report
pytest --cov=src --cov-report=term-missing

利用可能なツール

プレイヤー情報

• get_player_profile - Chess.com からプレイヤーのプロフィールを取得する

• get_player_stats - Chess.com からプレイヤーの統計情報を取得します

• is_player_online - Chess.com でプレイヤーが現在オンラインかどうかを確認します

• get_titled_players - Chess.com からタイトルを持つプレイヤーのリストを取得します

ゲーム

• get_player_current_games - Chess.com でプレイヤーの進行中のゲームを取得します

• get_player_games_by_month - Chess.com から特定の月のプレイヤーのゲームを取得します

• get_player_game_archives - Chess.com のプレイヤーの利用可能な月間ゲームアーカイブのリストを取得します

• download_player_games_pgn - Chess.com から特定の月のすべてのゲームの PGN ファイルをダウンロードします

クラブ

• get_club_profile - Chess.com のクラブに関する情報を取得します

• get_club_members - Chess.com のクラブのメンバーを取得する

ライセンス

マサチューセッツ工科大学