MCP Gradle

🚀 Gradle Tomcat MCP Server

Gradle Tomcat MCP Server 是一個模型上下文協議（MCP）服務器，用於管理基於 Gradle 的 Tomcat 應用程序，並且具備日誌查詢功能。

✨ 主要特性

• 進程管理：通過 Gradle 啟動、停止、重啟和監控 Tomcat 進程。
• 日誌管理：捕獲、存儲和過濾查詢應用程序日誌。
• 即時監控：流式傳輸日誌和進程狀態更新。
• MCP 集成：與 Claude 和其他 MCP 客戶端完全集成。

📦 安裝指南

全局安裝（推薦）

npm install -g mcp-gradle-tomcat

本地安裝

npm install mcp-gradle-tomcat

從源代碼安裝

git clone https://github.com/your-username/mcp-gradle-tomcat.git
cd mcp-gradle-tomcat
npm install

🚀 快速開始

1. 添加到 Claude 配置

將以下內容添加到你的 Claude 配置文件（~/.claude/config.json）中：

{
  "mcpServers": {
    "gradle-tomcat": {
      "command": "mcp-gradle-tomcat",
      "env": {
        "GRADLE_WORKING_DIR": "/path/to/your/gradle/project"
      }
    }
  }
}

2. 與 Claude 配合使用

配置完成後，你可以在 Claude 中使用以下命令：

• “啟動 Tomcat” - 啟動你的 Gradle 應用程序。
• “停止 Tomcat” - 優雅地停止正在運行的應用程序。
• “獲取 Tomcat 狀態” - 顯示進程狀態和運行時間。
• “獲取最近的日誌” - 過濾檢索應用程序日誌。
• “重啟 Tomcat” - 停止並重新啟動應用程序。

💻 使用示例

直接執行

# 設置你的項目目錄
export GRADLE_WORKING_DIR="/path/to/your/gradle/project"

# 運行 MCP 服務器
mcp-gradle-tomcat

測試工具

# 測試單個工具
npm test

📚 詳細文檔

配置

可以通過環境變量進行配置：

可用工具

start_tomcat

通過 Gradle 啟動 Tomcat

• gradle_command（可選）：要運行的 Gradle 命令
• working_directory（可選）：工作目錄

stop_tomcat

終止 Tomcat 進程

• force（可選）：使用 SIGKILL 強制終止

restart_tomcat

停止並啟動 Tomcat

• force（可選）：停止期間強制終止
• gradle_command（可選）：重啟時的 Gradle 命令

get_tomcat_status

檢查 Tomcat 進程狀態

• 無參數

get_logs

檢索日誌條目

• lines（可選）：最近的日誌行數（默認：100）
• level（可選）：最小日誌級別（DEBUG、INFO、WARN、ERROR）
• since（可選）：用於過濾的 ISO 8601 時間戳
• source（可選）：按來源過濾（stdout、stderr）

clear_logs

清除日誌緩衝區和文件

• confirm（必需）：必須為 true 才能確認

🔧 技術細節

架構

src/
├── server.js          # 主 MCP 服務器
├── process-manager.js # Tomcat 生命週期管理  
├── log-manager.js     # 日誌捕獲和查詢
├── tools/             # MCP 工具實現
└── config.js          # 配置管理

📄 許可證

本項目採用 MIT 許可證。