Mcss MCP Server

🚀 MCSS MCP 服務器

一個藉助 MCSS（Minecraft 服務器軟件）API 來控制 Minecraft 服務器的 MCP（模型上下文協議）服務器。該工具能讓您使用如 Claude Desktop 這類 MCP 客戶端，與您的 Minecraft 服務器實現無縫交互。

🚀 快速開始

📦 安裝指南

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": []
         }
       }
     }
     

   • 將路徑替換為您系統上實際的批處理文件路徑

✨ 主要特性

• 服務器管理

  • 列出所有由 MCSS 管理的 Minecraft 服務器
  • 獲取特定服務器的詳細信息
  • 執行電源操作（啟動、停止、重啟、終止）
  • 執行 Minecraft 命令
  • 即時查看服務器控制檯輸出
  • 更新服務器設置（名稱、描述、崩潰處理等）

• 備份管理

  • 列出可用備份
  • 創建新的備份配置
  • 在需要時運行備份

• 調度程序管理

  • 列出計劃任務
  • 創建新的計劃任務（命令、備份、服務器操作）
  • 更新現有任務
  • 刪除任務
  • 在需要時運行任務

💻 使用示例

基礎用法

在 Claude Desktop 中使用 MCP 工具，一旦啟動 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 客戶端實現