Lichess MCP

🚀 Lichess MCP 説明ドキュメント（日本語訳）

Lichess MCP は、Model Context Protocol (MCP) を通じて Lichess 対局プラットフォームとのやり取りを実現するツールです。ユーザーは自然言語を使って Claude Desktop 上でチェスゲームを管理し、局面を分析し、対局に関連する様々な操作を実行できます。

🚀 クイックスタート

Lichess MCP を使って Lichess 対局プラットフォームとのやり取りを始めるには、以下の手順に従ってください。

✨ 主な機能

• 自然言語を使って Claude Desktop 上でチェスゲームを管理する。
• 局面を分析する。
• 対局に関連する様々な操作を実行する。

📦 インストール

1. 依存関係のインストール

必要な依存関係をインストールするには、以下のコマンドを実行してください。

npm install -g lichess-mcp

2. 環境変数の設定

Lichess API トークンを設定するには、2 つの方法があります。

方法一：.env ファイルを使用する

プロジェクトのルートディレクトリに .env ファイルを作成し、以下の内容を追加してください。your-lichess-api-token を実際の API トークンに置き換えてください。

LICHESS_TOKEN=your-lichess-api-token

方法二：実行時に設定する

コード内で set_token 関数を使用してトークンを設定することもできます。

const { set_token } = require('lichess-mcp');
set_token({ LICHESS_TOKEN: 'your-lichess-api-token' });

3. ビルドとインストール

プロジェクトをビルドし、グローバルパッケージとしてインストールします。

npm install -g

4. サーバーの起動（オプション）

MCP サーバーを独立して実行する場合は、以下のコマンドを実行してください。

npm start

📚 ドキュメント

Claude Desktop の設定

Lichess MCP を Claude Desktop と統合するには、以下の手順に従ってください。

1. Claude Desktop の設定ファイルを開きます。

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

2. 設定ファイルに以下の内容を追加し、your-lichess-api-token を実際のトークンに置き換えてください。

{
  "mcpServers": {
    "lichess": {
      "command": "lichess-mcp",
      "env": {
        "LICHESS_TOKEN": "your-lichess-api-token",
        "DEBUG": "*"
      }
    }
  }
}

3. オプション：他の MCP サーバー（例えばファイルシステムアクセス）を追加する場合は、以下の形式で追加してください。

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/Users/username/Downloads"
      ]
    },
    "lichess": {
      "command": "lichess-mcp",
      "env": {
        "LICHESS_TOKEN": "your-lichess-api-token"
      }
    }
  }
}

4. Claude Desktop を再起動し、MCP サーバーが正しく接続されていることを確認します。画面にハンマーアイコンが表示されれば、MCP サーバーが接続されています。

5. テスト：Claude に Lichess のプロフィールを表示させたり、新しい対局を開始させたりしてみてください。

   • "Show me my Lichess profile"
   • "Start a new chess game with 10 minutes time control"

トラブルシューティング

問題が発生した場合は、以下の点を確認してください。

1. lichess-mcp がグローバルにインストールされていることを確認します。
2. lichess-mcp コマンドが PATH 内で使用可能であることを確認します (which lichess-mcp)。
3. 設定ファイルの形式が正しく、mcpServers フィールドを使用していることを確認します（古い mcp_servers 形式ではないこと）。
4. Claude Desktop を完全に再起動してから再度試してみてください。
5. 開発者モードを有効にして、より詳細なログ情報を取得します。

参考資料

• Model Context Protocol
• Lichess API ドキュメント