MCP Chess

🚀 MCP チェスサーバー

Claude AI アシスタントにチェス機能を提供する Model Context Protocol (MCP) サーバーです。

https://github.com/user-attachments/assets/324ed381-35f3-45b7-b877-127ef27fd97d

✨ 主な機能

このサーバーは、Claude の機能を拡張するツールを実装しています。

• Forsyth-Edwards Notation (FEN) 文字列からチェス盤の画像を生成する
• チェスゲームにおける次の一手を提案する
• ある手が合法かどうかをチェックする

📦 インストール

Claude Desktop でのインストール

1. Releases ページから最新のバイナリファイルをダウンロードします。

   • Windows: mcp-chess-windows.exe
   • macOS: mcp-chess-darwin
   • Linux: mcp-chess-linux

2. ファイルに実行権限を付与します（macOS/Linux のみ）。

   chmod +x mcp-chess-darwin   # macOS の場合
   chmod +x mcp-chess-linux    # Linux の場合
   

3. macOS ユーザー - セキュリティ警告を回避する

   初めてアプリケーションを実行しようとすると、macOS はアプリケーションが認識された開発者によって署名されていないため、セキュリティ警告を表示することがあります。これを回避するには、以下の操作を行います。

   • mcp-chess-darwin ファイルを右クリック（または Control クリック）します。
   • コンテキストメニューから「開く」を選択します。
   • 表示されるダイアログで「開く」をクリックします。

   または、ターミナルを使用することもできます。

   xattr -d com.apple.quarantine /path/to/mcp-chess-darwin
   

   この操作は一度だけ行えばよいです。

4. Claude Desktop を設定します。

   • Claude Desktop を開きます。
   • 「設定」を選択し、「開発者」タブをクリックします。
   • 「編集設定」をクリックします。
   • MCP サーバーの設定を追加します。
   • ファイルを保存します。
   • Claude Desktop を再起動します。

以下は、MCP サーバー設定の例です。

{
  "mcpServers": {
    "mcp-chess": {
      "command": "/path/to/mcp-chess-binary"
    }
  }
}

💻 使用例

基本的な使用法

設定が完了したら、Claude に様々なチェス関連のタスクを実行させることができます。

チェスゲームの初期位置を表示して。

ゲームを開始しましょう。各手が合法かどうかをチェックして、次の最善手を提案して。

Nf3 は初期位置からの合法な手ですか？

以下の位置： "rnbqkbnr/pppp1ppp/8/4p3/4P3/8/PPPP1PPP/RNBQKBNR w KQkq - 0 2" において、白の良い手は何ですか？

🔧 技術詳細

開発

このプロジェクトは以下の技術を使用して構築されています。

• Spring Boot
• Spring AI（MCP サーバーの実装）
• Java 21
• GraalVM ネイティブコンパイル

ソースコードからのビルド

# リポジトリをクローンする
git clone https://github.com/alexandreroman/mcp-chess.git
cd mcp-chess

# Maven を使用してビルドする
./mvnw clean package

# ネイティブ実行ファイルをビルドする
./mvnw -Pnative native:compile

📄 ライセンス

このプロジェクトは Apache License 2.0 の下で公開されています。詳細については LICENSE ファイルを参照してください。

参考リンク

• ChessGame - Java チェスライブラリ
• ChessImage - チェス盤レンダラー
• Stockfish.online - チェスエンジン API
• Spring AI - AI アプリケーションフレームワーク