remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides access to Chess.com player data, profiles, statistics, game records, online status checks, club information, and titled player lists through Chess.com's Published Data API.

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 クライアントで使用できるようにするツールを選択できます。

使用法

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

ライセンス

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

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

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

Appeared in Searches

A search for games