リッチチェスMCP

鍛冶屋のバッジ

Lichessに自然言語で話しかけて、チェスプラットフォームと対話しましょう。Claude Desktopと連携して、ゲームをプレイしたり、ポジションを分析したり、チェスの活動を管理したりできます。

モデルコンテキストプロトコルを使用して構築されました。

サーバーにより、次のことが可能になります。

Lichessアカウントの管理
チェスのゲームやチャレンジをする
ポジションとゲームの分析
トーナメントやチームに参加する
他のプレイヤーとの交流

構成

Lichess API トークンは次の 2 つの方法で設定できます。

環境変数: プロジェクトルートの.envファイルに追加するか、直接設定します。
LICHESS_TOKEN=your-lichess-api-token
実行時にset_tokenツールを使用する:
set_token({ token: "your-lichess-api-token" });

トークンはhttps://lichess.org/account/oauth/tokenで生成できます。

Related MCP server: Claude-LMStudio Bridge

利用可能なツール

1. アカウント管理

// Set your Lichess API token set_token({ token: "your-lichess-api-token" }); // Get your Lichess profile get_my_profile(); // Get another user's profile get_user_profile({ username: "player_name", trophies: true // include trophies, optional });

2. ゲームプレイ

// Create a challenge against another player create_challenge({ username: "opponent_username", timeControl: "10+0", // 10 minutes, no increment color: "random" // or "white", "black" }); // Make a move in a game make_move({ gameId: "abcd1234", move: "e2e4", offeringDraw: false }); // Get your ongoing games get_ongoing_games({ nb: 10 // number of games to fetch });

3. ゲーム分析

// Export a game in PGN format export_game({ gameId: "abcd1234", clocks: true, evals: true }); // Get cloud evaluation for a position get_cloud_eval({ fen: "rnbqkbnr/ppp1pppp/8/3p4/4P3/8/PPPP1PPP/RNBQKBNR w KQkq - 0 2" });

4. トーナメント

// List current tournaments get_arena_tournaments(); // Join a tournament join_arena({ tournamentId: "abc123" }); // Create a new tournament create_arena({ name: "My Tournament", clockTime: 3, clockIncrement: 2, minutes: 45 });

チェスの記法

移動形式

Lichess API は次の形式の動きを受け入れます:

UCI : ユニバーサルチェスインターフェース形式（例： e2e4 、 g8f6 ）
SAN : 標準代数記法（例： e4 、 Nf6 ） - 一部のエンドポイントのみ

FENフォーマット

フォーサイス・エドワーズ記法 (FEN) はチェスの位置を表すために使用されます。

rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1

これは次を表します:

駒の位置（8段目から1段目まで）
アクティブカラー（白黒）
キャスリングの可用性（KQkq）
アンパッサンターゲットスクエア
ハーフムーブクロック
フルムーブ数

エラー処理

サーバーは、次の詳細なエラーメッセージを提供します。

無効な動きや位置
認証の問題
レート制限
リソースが見つからないケース

セットアップ手順

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Lichess Integration を自動的にインストールするには:

npx -y @smithery/cli install @karayaman/lichess-mcp --client claude

手動インストール

リポジトリをクローンします。
git clone https://github.com/karayaman/lichess-mcp.git cd lichess-mcp
依存関係をインストールします:
npm install
環境変数を設定します。ルートディレクトリに.envファイルを作成します。
LICHESS_TOKEN=your-lichess-api-token
プロジェクトをビルドします。
npm run build
パッケージをグローバルにインストールします (Claude Desktop 統合の場合は推奨)。
npm install -g
サーバーを起動します (スタンドアロン使用の場合):
npm start

Claudeデスクトップの設定

この MCP サーバーを Claude Desktop で使用するには:

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
Lichess MCP サーバーを構成に追加します。
{ "mcpServers": { "lichess": { "command": "lichess-mcp", "env": { "LICHESS_TOKEN": "your-lichess-api-token", "DEBUG": "*" } } } }
注: your-lichess-api-token実際のDEBUG APIトークンに置き換えてください。DEBUG環境変数はオプションですが、トラブルシューティングに役立ちます。
(オプション) 他の 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" } } } }
変更を適用するには、Claude Desktop を再起動します。
- Claude Desktop を完全に閉じてください (システムトレイ/メニューバーからでも閉じられます)
- Claude Desktopを再度起動します
- インターフェースでハンマーアイコンを探します。これはMCPサーバーが接続されていることを示します。
Claude に Lichess アカウントについて問い合わせて、統合をテストします。
- 「Lichessプロフィールを見せてください」
- 「10分の時間制限で新しいチェスゲームを開始する」