lichess-mcp

Claude를 Lichess에 연결하는 Model Context Protocol (MCP) 서버입니다. Claude에서 직접 체스를 두고, 포지션을 분석하고, 퍼즐을 풀고, 도전을 관리하고, 통계를 탐색하세요.

설치

Claude Desktop

Claude Desktop 설정에 다음을 추가하세요:

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "lichess-mcp": {
      "command": "npx",
      "args": ["-y", "lichess-mcp"]
    }
  }
}

저장 후 Claude Desktop을 재시작하세요.

Claude Code

claude mcp add lichess-mcp -- npx -y lichess-mcp

인증

설치 후 Claude에게 **"start Lichess auth"**라고 요청하세요. 브라우저 창이 열리면 Lichess 계정으로 앱을 승인할 수 있습니다. 토큰은 로컬의 ~/.lichess-mcp-auth/token.json에 캐시되며 향후 세션에서 자동으로 재사용됩니다.

도구

인증

도구	설명
`lichess_auth_start`	OAuth 로그인 시작 — 브라우저 창 열기
`lichess_auth_status`	로그인 상태 확인

계정 및 사용자

도구	설명
`lichess_get_my_profile`	내 레이팅 및 계정 통계
`lichess_get_user`	모든 플레이어의 공개 프로필
`lichess_get_my_games`	최근 게임 기록 (색상, 레이팅/캐주얼별 필터링)
`lichess_get_rating_history`	모든 플레이어의 시간 경과에 따른 레이팅 기록
`lichess_get_crosstable`	두 플레이어 간의 상대 전적
`lichess_get_leaderboard`	시간 제어별 상위 플레이어 (불릿, 블리츠, 래피드 등)

도전

도구	설명
`lichess_list_challenges`	수신 및 발신 도전 목록
`lichess_accept_challenge`	수신된 도전 수락
`lichess_decline_challenge`	도전 거절 (선택적 사유 포함)
`lichess_cancel_challenge`	보낸 도전 취소
`lichess_create_challenge`	특정 플레이어에게 도전
`lichess_challenge_ai`	Stockfish AI와 대국 (레벨 1–8)

게임

도구	설명
`lichess_get_ongoing_games`	진행 중인 게임 목록
`lichess_make_move`	수 두기 (UCI 표기법, 예: `e2e4`)
`lichess_stream_game`	게임의 실시간 보드 상태 가져오기
`lichess_stream_events`	수신 이벤트 스트리밍 (도전, 게임 시작)
`lichess_abort`	게임 초반에 게임 중단
`lichess_resign`	게임 기권
`lichess_offer_draw`	무승부 제안, 수락 또는 거절
`lichess_takeback`	무르기 요청, 수락 또는 거절
`lichess_send_chat`	게임 내 채팅 메시지 전송

퍼즐 및 분석

도구	설명
`lichess_get_daily_puzzle`	오늘의 Lichess 퍼즐
`lichess_get_puzzle`	ID별 특정 퍼즐
`lichess_get_next_puzzle`	다음 추천 퍼즐
`lichess_get_puzzle_activity`	최근 퍼즐 기록 및 결과
`lichess_cloud_eval`	FEN 포지션에 대한 Stockfish 클라우드 평가

예시 프롬프트

"내 현재 블리츠 레이팅이 뭐야?"
"백으로 둔 최근 게임 5개를 보여줘"
"@DrNykterstein에게 5+3 레이팅 게임을 도전해"
"Stockfish 레벨 5, 10분 게임을 시작해, 내가 백으로 둘게"
"받은 도전 목록을 보여줘"
"도전 abc123을 수락해"
"Magnus와 Hikaru의 상대 전적은 어때?"
"불릿 상위 10명 플레이어를 보여줘"
"오늘의 퍼즐은 뭐야?"
"다음 퍼즐을 가져와"
"지난 50번의 시도에 대한 퍼즐 활동을 보여줘"
"이 포지션에서 최선의 수는 뭐야: rnbqkbnr/pppppppp/8/8/4P3/8/PPPP1PPP/RNBQKBNR b KQkq e3 0 1"
"현재 게임을 기권해"
"게임 xyz에서 상대에게 'good luck'이라고 메시지를 보내"

요구 사항

Node.js 18+
Lichess 계정

라이선스

MIT

Install Server

A

security – no known vulnerabilities

F

license - not found

A

quality - A tier

How are these scores calculated?

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Lichess MCP