MCSS MCP Server

MCSS MCP サーバー

MCSS（Minecraft Server Software）API を通じて Minecraft サーバーを制御するための Model Context Protocol（MCP）サーバーです。このツールを使うと、Claude Desktop などの MCP クライアントから Minecraft サーバーをスムーズに操作できます。

🌟 機能

• サーバー管理

  • MCSS が管理するすべての Minecraft サーバーを一覧表示します
  • 特定のサーバーの詳細情報を取得します
  • 電源操作（起動、停止、再起動、強制終了）を実行します
  • Minecraft コマンドを実行します
  • サーバーのコンソール出力をリアルタイムで表示します
  • サーバー設定（名前、説明、クラッシュ処理など）を更新します

• バックアップ管理

  • 利用可能なバックアップを一覧表示します
  • 新しいバックアップ設定を作成します
  • 必要に応じてバックアップを実行します

• スケジューラー管理

  • スケジュール済みタスクを一覧表示します
  • 新しいスケジュール済みタスク（コマンド、バックアップ、サーバー操作）を作成します
  • 既存のタスクを更新します
  • タスクを削除します
  • 必要に応じてタスクを実行します

📋 前提条件

• Python 3.10 以降
• Web API が有効な MCSS（Minecraft Server Software）
• MCSS Web API 用の API キー
• Claude Desktop（MCP クライアント機能を使用する場合）

🚀 クイックスタート

インストール

1. このリポジトリをクローンします：

   git clone https://github.com/largeorbitalobject/mcss-mcp-server.git
   cd mcss-mcp-server
   

2. 仮想環境を作成して有効にします：

   python -m venv venv
   # On Windows
   .\venv\Scripts\activate
   # On Linux/Mac
   source venv/bin/activate
   

3. 必要な依存関係をインストールします：

   pip install mcp[cli] httpx python-dotenv
   

設定

1. プロジェクトのルートディレクトリに .env ファイルを作成します：

   MCSS_HOST=your_mcss_host_ip
   MCSS_PORT=25560
   MCSS_API_KEY=your_mcss_api_key
   

2. この MCP サーバーを使用するよう Claude Desktop を設定します：

   • Claude Desktop の設定ファイルを開きます：
     • Windows：%AppData%\Claude\claude_desktop_config.json
     • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • 次の設定を追加します：

     {
       "mcpServers": {
         "mcss-control": {
           "command": "C:\\path\\to\\mcss-mcp-server\\run_mcss_mcp.bat",
           "args": []
         }
       }
     }
     

   • パスを、お使いのシステム上のバッチファイルの実際のパスに置き換えます

🔧 Claude Desktop での MCP ツールの使用

Claude Desktop を起動するとサーバーが自動的に開始され、次のツールを使用できます：

サーバー管理

get_servers()

MCSS が管理するすべての Minecraft サーバーの一覧を返します。

get_server_details(server_id)

特定のサーバーの詳細情報を返します。

edit_server(server_id, name=None, description=None, is_set_to_auto_start=None, force_save_on_stop=None, java_allocated_memory=None, keep_online=None)

特定の Minecraft サーバーの設定を更新します。keep_online パラメーターはクラッシュ処理を制御します（0＝なし、1＝強化、2＝積極的）。

execute_server_action(server_id, action)

サーバーに電源操作を実行します。有効な操作は start、stop、restart、kill です。

execute_server_command(server_id, command)

サーバーで Minecraft コマンドを実行します。

get_server_console(server_id, lines=50)

サーバーのコンソール出力を返します。

バックアップ管理

get_backups(server_id)

サーバーのバックアップ一覧を返します。

create_backup(server_id, name, description="", compression=None)

新しいバックアップ設定を作成します。

run_backup(server_id, backup_id)

サーバーのバックアップを実行します。

スケジューラー管理

get_scheduler_tasks(server_id)

サーバーのスケジュール済みタスクの一覧を返します。

create_scheduler_task(server_id, name, enabled=True, ...)

新しいスケジュール済みタスクを作成します。

update_scheduler_task(server_id, task_id, name=None, ...)

既存のスケジュール済みタスクを更新します。

delete_scheduler_task(server_id, task_id)

スケジュール済みタスクを削除します。

run_scheduler_task(server_id, task_id)

スケジュール済みタスクをただちに実行します。

📁 プロジェクト構成

mcss-mcp-server/
├── mcss_mcp/                # Main package
│   ├── __init__.py          # Package initialization
│   └── server.py            # MCP server implementation
├── main.py                  # Entry point script
├── run_mcss_mcp.bat         # Batch script to run the server
├── .env                     # Environment variables (not in repo)
└── README.md                # This file

🤝 貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細は LICENSE ファイルをご覧ください。

🙏 謝辞

• Minecraft サーバー管理ソフトウェアを提供している MCSS に感謝します
• Model Context Protocol の仕様を提供している MCP に感謝します
• MCP クライアントの実装を提供している Claude Desktop に感謝します