Mcss MCP Server

🚀 MCSS MCP サーバー

このサーバーは、MCSS（Minecraft サーバーソフトウェア）API を通じて Minecraft サーバーを制御する MCP（モデルコンテキストプロトコル）サーバーです。Claude Desktop のような MCP クライアントを使用して、Minecraft サーバーとシームレスにやり取りできます。

✨ 主な機能

サーバー管理

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

バックアップ管理

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

スケジューラー管理

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

📦 インストール

前提条件

• Python 3.10 以上
• Web API が有効になっている MCSS（Minecraft サーバーソフトウェア）
• 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
   # Windows の場合
   .\venv\Scripts\activate
   # 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. Claude Desktop をこの MCP サーバーを使用するように設定します：

   • Claude Desktop の設定ファイルを開きます：
     • Windows：%AppData%\Claude\claude_desktop_config.json%
     • macOS：%home%/.config/Claude/claude_desktop_config.json%
   • 以下の設定を追加します：

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

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

💻 使用例

基本的な使用法

Claude Desktop を起動すると、サーバーが自動的に起動し、以下のツールを使用できます。

サーバー管理

get_servers()

MCSS で管理されているすべての Minecraft サーバーのリストを返します。

get_server_details(server_id)

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

set_server_settings(server_id, settings)

指定されたサーバーの設定を更新します。

restart_server(server_id)

指定されたサーバーを再起動します。

shutdown_server(server_id)

指定されたサーバーを停止します。

バックアップ管理

create_backup(server_id)

指定されたサーバーのバックアップを作成します。

delete_backup(server_id, backup_id)

指定されたサーバーの特定のバックアップを削除します。

get_backups(server_id)

指定されたサーバーのすべてのバックアップのリストを返します。

スケジューラー管理

create_schedule(server_id, schedule)

指定されたサーバーの新しい予定タスクを作成します。

delete_schedule(server_id, schedule_id)

指定されたサーバーの特定の予定タスクを削除します。

get_schedules(server_id)

指定されたサーバーのすべての予定タスクのリストを返します。

run_schedule(server_id, schedule_id)

指定されたサーバーの特定の予定タスクをすぐに実行します。

📚 ドキュメント

プロジェクト構造

mcss-mcp-server/
├── mcss_mcp/                # メインパッケージ
│   ├── __init__.py          # パッケージ初期化
│   └── server.py            # MCP サーバーの実装
├── main.py                  # エントリースクリプト
├── run_mcss_mcp.bat         # サーバーを実行するバッチスクリプト
├── .env                     # 環境変数（リポジトリには含まれません）
└── README.md                # このファイル

🤝 コントリビューション

コントリビューションを歓迎します！自由に Pull Request を送信してください。

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細については、LICENSE ファイルを参照してください。

🙏 謝辞

• MCSS：Minecraft サーバー管理ソフトウェアを提供
• MCP：モデルコンテキストプロトコルの仕様を提供
• Claude Desktop：MCP クライアントの実装を提供