Lichess MCP

🚀 Lichess MCP 說明文檔

Lichess MCP 是一款藉助 Model Context Protocol (MCP) 實現與 Lichess 對弈平臺交互的工具。用戶能夠在 Claude Desktop 上通過自然語言管理棋盤遊戲、分析棋局，還能執行各類對弈相關操作。

🚀 快速開始

Lichess MCP 可幫助用戶在 Claude Desktop 上與 Lichess 對弈平臺進行交互，實現自然語言管理棋盤遊戲等功能。以下為你詳細介紹配置和使用方法。

📦 安裝指南

1. 安裝依賴

請依照以下步驟安裝所需依賴項：

npm install -g lichess-mcp

2. 環境變量配置

有兩種方式可設置 Lichess API 令牌：

方法一：使用 .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 文檔