MCP Stockfish

🚀 mcp-stockfish 🐟

このプロジェクトは、AIシステムとStockfishチェスエンジンをMCPプロトコルを介して接続するブリッジを作成します。これにより、AIがStockfishと対話できるようになり、チェスエンジンへのアクセスがより容易になります。

🧠⚡🖥️ あなたの大規模言語モデルが思考し、Stockfishが計算し、あなたはその結果の15手の戦術シーケンスを理解しているふりをします。

🚀 クイックスタート

📦 インストール

git clone https://github.com/sonirico/mcp-stockfish
cd mcp-stockfish
make install

💻 使用例

基本的な使用法

# デフォルトモード (stdio, 古き良き方法)
mcp-stockfish

高度な使用法

# カスタムStockfishパスを指定する場合
MCP_STOCKFISH_PATH=/your/special/stockfish mcp-stockfish

# HTTPモード (ウェブ規模のユースケース向け)
MCP_STOCKFISH_SERVER_MODE=http mcp-stockfish

✨ 主な機能

• 🔄 同時セッション: CPUを苦しめることなく、複数のStockfishインスタンスを実行できます。
• ⚡ 完全なUCIサポート: 必要なコマンドはすべてサポートし、不要なものは一切含まれません。
• 🎯 実際に動作する: 前回のサイドプロジェクトとは異なり、適切なエラーハンドリングが実装されています。
• 📊 すべてJSON形式: 単なるテキストではなく、JSON形式でデータを扱います。
• 🐳 Docker対応: ローカル環境を破壊してしまったときのために、コンテナ化されています。

📚 ドキュメント

サポートされるUCIコマンド ♟️

設定 ⚙️

環境変数

サーバー設定

• MCP_STOCKFISH_SERVER_MODE: "stdio" または "http" (デフォルト: "stdio")
• MCP_STOCKFISH_HTTP_HOST: HTTPホスト (デフォルト: "localhost")
• MCP_STOCKFISH_HTTP_PORT: HTTPポート (デフォルト: 8080)

Stockfish 🐟 設定

• MCP_STOCKFISH_PATH: Stockfishバイナリのパス (デフォルト: "stockfish")
• MCP_STOCKFISH_MAX_SESSIONS: 最大同時セッション数 (デフォルト: 10)
• MCP_STOCKFISH_SESSION_TIMEOUT: セッションタイムアウト (デフォルト: "30m")
• MCP_STOCKFISH_COMMAND_TIMEOUT: コマンドタイムアウト (デフォルト: "30s")

ロギング

• MCP_STOCKFISH_LOG_LEVEL: debug, info, warn, error, fatal
• MCP_STOCKFISH_LOG_FORMAT: json, console
• MCP_STOCKFISH_LOG_OUTPUT: stdout, stderr

ツールパラメータ

• command: 実行するUCIコマンド
• session_id: セッションID (オプション、指定しない場合は自動生成されます)

レスポンス形式

{
  "status": "success|error", 
  "session_id": "some-uuid",
  "command": "what you asked for",
  "response": ["what stockfish said"],
  "error": "what went wrong (if anything)"
}

セッション管理

セッションは以下のように動作します:

• 必要に応じてStockfishプロセスを起動します。
• コマンド間でUCIの状態を保持します。
• セッション終了時 (またはタイムアウト時) にクリーンアップします。
• 制限を適用して、フォークボムを防ぎます。

統合

Claude Desktop

{
  "mcpServers": {
    "chess": {
      "command": "mcp-stockfish",
      "env": {
        "MCP_STOCKFISH_LOG_LEVEL": "info"
      }
    }
  }
}

開発

make deps     # 依存関係を取得する
make build    # ビルドする
make test     # テストを実行する (テストが存在する場合)
make fmt      # コードを整形する

🔧 技術詳細

このプロジェクトは mark3labs/mcp-go をベースに構築されています。これにより、MCPプロトコルの処理を効率的に行うことができます。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。自由に利用してくださいが、不具合が発生した場合には責任を負いません。

クレジット 🐟

本プロジェクトは Stockfish をパワードしています。このチェスエンジンは私たち二人を合わせた以上に強力です。また、以下の方々やプロジェクトに感謝します。

• Stockfishチーム が素晴らしいチェスエンジンを開発してくれたこと。
• MCP SDK for Go がプロトコルの処理を代行してくれたこと。
• コーヒー。