Skip to main content
Glama
Sign In
enesjakozh

Lichess MCP

by karayaman
GitHub
JavaScript
MIT License
2
  • Apple
  • Linux
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

リッチチェスMCP

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

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

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

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

構成

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

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

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

利用可能なツール

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

手動インストール

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

Claudeデスクトップの設定

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

トラブルシューティング

MCP サーバー接続で問題が発生した場合:

  1. npm install -gでパッケージがグローバルにインストールされていることを確認してください。
  2. lichess-mcpコマンドが PATH で使用可能であることを確認します ( which lichess-mcp )
  3. 設定ファイルの形式が正しいことを確認してください（ mcp_serversではなく新しいmcpServers形式）。
  4. Claude Desktopを完全に再起動します
  5. 追加のログ記録のために、Claude Desktop で開発者モードを有効にしてみてください（利用可能な場合）。
  6. Lichess APIトークンが有効であることを確認してください

参考文献

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

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.

Tools

View all tools

Lichess チェス プラットフォームとの自然言語によるインタラクションを可能にする MCP サーバー。ユーザーは Claude を通じてゲームをプレイしたり、ポジションを分析したり、アカウントを管理したり、トーナメントに参加したりできます。

  1. 構成
    1. 利用可能なツール
      1. アカウント管理
      2. ゲームプレイ
      3. ゲーム分析
      4. トーナメント
    2. チェスの記法
      1. 移動形式
      2. FENフォーマット
    3. エラー処理
      1. セットアップ手順
        1. Smithery経由でインストール
        2. 手動インストール
      2. Claudeデスクトップの設定
        1. トラブルシューティング
          1. 参考文献

            Related Resources

            Related MCP Servers

            • Clanki

              jasperket
              -
              security
              F
              license
              -
              quality
              An MCP server that enables AI assistants like Claude to interact with Anki flashcard decks, allowing users to create, manage, and update flashcards through natural language conversations.
              Last updated -
              1
              TypeScript

            • Game Asset Generator

              MubarakHAlketbi
              -
              security
              A
              license
              -
              quality
              An MCP server that generates 2D and 3D game assets from text prompts using AI models from Hugging Face Spaces, allowing developers to easily create game art through Claude Desktop or other MCP clients.
              Last updated -
              34
              JavaScript
              MIT License
              • Apple
              • Linux

            • Minesweeper MCP Server

              tonypan2
              -
              security
              F
              license
              -
              quality
              An MCP server that enables AI agents like Claude to play Minesweeper through natural language interaction, connecting to a separate Minesweeper game server.
              Last updated -
              80
              JavaScript

            • GOAT MCP Server

              cryptoleek-team
              -
              security
              F
              license
              -
              quality
              An MCP server that connects Claude for Desktop with blockchain functionality, allowing users to check balances and send tokens on EVM and Solana chains through natural language interactions.
              Last updated -
              TypeScript
              • Apple

            View all related MCP servers

            Appeared in Searches

            New MCP Servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/karayaman/lichess-mcp'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server