Mcss MCP Server

MCPプロトコルに基づくMCSSサーバー制御ツールで、APIを通じてMinecraftサーバーの包括的な管理を実現します。サーバー操作、バックアップ管理、タスクスケジューリングなどの機能があります。

ゲームとゲーム化開発者ツール #Minecraft管理 #サーバー制御 #タスクスケジューリング #バックアップ管理 .Python

スコア : 2ポイント

ダウンロード数 : 9.7K

更新時間 : 2025-04-28

サイトを開く

MCSS MCPサーバーとは？

MCSS MCPサーバーは、Model Context Protocol (MCP)に基づくツールで、簡単なコマンドでMinecraftサーバーを管理できます。ゲームサーバーの起動、停止、バックアップ、監視などの強力な機能を提供します。

MCSS MCPサーバーの使い方は？

数ステップで使用を開始できます。ソフトウェアをインストールし、環境変数を設定してサーバーを起動します。その後、Claude Desktopや他のMCPクライアントで直接操作できます。

適用シーン

複数のMinecraftサーバーを効率的に管理する必要があるプレイヤーや管理者に適しています。特に、バックアップやスケジューリングなどのタスクを自動化したいユーザーに最適です。

主要機能

サーバー管理

すべてのサーバーをリスト表示、詳細を取得、起動/停止などの操作を実行します。

バックアップ管理

サーバーのバックアップを作成、表示、実行します。

スケジューラー管理

定期的なバックアップやコマンドの実行など、タイマータスクを設定します。

利点

複数のサーバー管理操作をサポートし、作業フローを簡素化します。

既存のシステムに容易に統合できます。

オープンソースで無料で使用できます。

制限

Python環境と依存関係をインストールする必要があります。

高負荷のサーバーではパフォーマンスのボトルネックが発生する可能性があります。

使い方

MCSS MCPサーバーのインストール

リポジトリをクローンし、仮想環境を設定します。

環境変数の設定

.envファイルを作成し、必要な情報を記入します。

サーバーの起動

バッチスクリプトを実行してMCPサーバーを起動します。

使用例

すべてのサーバーをリスト表示

現在稼働中のすべてのMinecraftサーバーを表示します。

バックアップの作成

特定のサーバーの新しいバックアップを生成します。

よくある質問

APIキーの安全性を確保するにはどうすればいいですか？

サーバーに接続できないのはなぜですか？

🚀 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 クライアント機能に必要）

手順

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

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

仮想環境を作成してアクティブ化します：

python -m venv venv
# Windows の場合
.\venv\Scripts\activate
# Linux/Mac の場合
source venv/bin/activate

必要な依存関係をインストールします：
```
pip install mcp[cli] httpx python-dotenv
```

設定

プロジェクトのルートディレクトリに .env ファイルを作成します：
```
MCSS_HOST=your_mcss_host_ip
MCSS_PORT=25560
MCSS_API_KEY=your_mcss_api_key
```
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                # このファイル