Chess.com MCP Server

Chess.com MCP サーバー

Chess.com の公開データ API 用の Model Context Protocol（MCP）サーバーです。

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

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

機能

• プレイヤーのプロフィール、統計、対局記録にアクセス
• 日付とプレイヤーで対局を検索
• プレイヤーのオンライン状態を確認
• クラブや称号を持つプレイヤーの情報を取得
• 認証不要（Chess.com の公開 API を使用）
• Docker コンテナ化に対応
• AI アシスタント向けの対話型ツールを提供

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

使用方法

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 のクラブのメンバーを取得

ライセンス

MIT

---