Chess MCP

🚀 チェス.com MCP サーバー

このサーバーは、チェス.com のデータ API を提供する モデルコンテキストプロトコル (MCP) サーバーです。標準化された MCP インターフェースを通じて、チェス.com のプレイヤーデータ、ゲーム記録、その他の公開情報にアクセスでき、AI アシスタントがチェス情報を検索および分析することを可能にします。

リンク

✨ 主な機能

• [x] プレイヤーのプロフィール、統計情報、ゲーム記録にアクセス
• [x] 日付とプレイヤーでゲームを検索
• [x] プレイヤーのオンライン状態を確認
• [x] クラブと称号を持つプレイヤーの情報を取得
• [x] 認証不要（チェス.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 を設定する必要がある場合があります。

💻 使用例

基本的な使用法

以下は、Docker を使用してサーバーを起動する基本的なコード例です。

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

高度な使用法

直接 UV を使用してサーバーを起動する高度なコード例です。

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

🔧 開発

ご提案や改善点があれば、Issue を開くか Pull Request を送信してください。

このプロジェクトは、依存関係の管理に uv を使用しています。uv をプラットフォームの説明に従ってインストールします：

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

次に、仮想環境を作成し、依存関係をインストールします：

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

テスト

このプロジェクトにはテストスイートが含まれており、機能を保証し、回帰を防止します。

テストを実行するには：

npm test

📚 ドキュメント

以下は、MCP サーバーがサポートするツールのリストです：

• get_player_profile: プレイヤーのプロフィール情報を取得します。
• search_games_by_date: 日付でゲーム記録を検索します。
• check_online_status: プレイヤーのオンライン状態を確認します。
• get_club_info: クラブの詳細情報を取得します。
• retrieve_titled_players: 特定の称号を持つプレイヤーのリストを取得します。

各ツールには、プロジェクトへの簡単な統合を支援する詳細なドキュメントとサンプルが用意されています。