MCP Gradle

🚀 Gradle Tomcat MCP Server

このアプリケーションは、GradleベースのTomcatアプリケーションを管理するためのModel Context Protocol (MCP)サーバーで、ログクエリ機能も備えています。

✨ 主な機能

• プロセス管理：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で以下のコマンドを使用できます。

• "Start Tomcat" - Gradleアプリケーションを起動します。
• "Stop Tomcat" - 実行中のアプリケーションを正常に停止します。
• "Get Tomcat status" - プロセスの状態と稼働時間を表示します。
• "Get recent logs" - フィルタリングを使用してアプリケーションのログを取得します。
• "Restart 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