MCP Gradle

🚀 Gradle Tomcat MCP Server

A Model Context Protocol (MCP) server for managing Gradle-based Tomcat applications with log querying capabilities.

🚀 Quick Start

1. Add to Claude Configuration

Add this to your Claude configuration file (~/.claude/config.json):

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

2. Use with Claude

Once configured, you can use these commands in Claude:

• "Start Tomcat" - Launches your Gradle application
• "Stop Tomcat" - Gracefully stops the running application
• "Get Tomcat status" - Shows process status and uptime
• "Get recent logs" - Retrieves application logs with filtering
• "Restart Tomcat" - Stops and starts the application

✨ Features

• Process Management: Start, stop, restart, and monitor Tomcat processes via Gradle
• Log Management: Capture, store, and query application logs with filtering
• Real-time Monitoring: Stream logs and process status updates
• MCP Integration: Full integration with Claude and other MCP clients

📦 Installation

Global Installation (Recommended)

npm install -g mcp-gradle-tomcat

Local Installation

npm install mcp-gradle-tomcat

From Source

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

💻 Usage Examples

Basic Usage

Direct Execution

# Set your project directory
export GRADLE_WORKING_DIR="/path/to/your/gradle/project"

# Run the MCP server
mcp-gradle-tomcat

Testing Tools

# Test individual tools
npm test

📚 Documentation

Configuration

Configuration can be set via environment variables:

Available Tools

start_tomcat

Launch Tomcat via Gradle

• gradle_command (optional): Gradle command to run
• working_directory (optional): Working directory

stop_tomcat

Terminate Tomcat process

• force (optional): Force termination with SIGKILL

restart_tomcat

Stop and start Tomcat

• force (optional): Force termination during stop
• gradle_command (optional): Gradle command for restart

get_tomcat_status

Check Tomcat process status

• No parameters

get_logs

Retrieve log entries

• lines (optional): Number of recent log lines (default: 100)
• level (optional): Minimum log level (DEBUG, INFO, WARN, ERROR)
• since (optional): ISO 8601 timestamp to filter from
• source (optional): Filter by source (stdout, stderr)

clear_logs

Clear log buffer and files

• confirm (required): Must be true to confirm

🔧 Technical Details

Architecture

src/
├── server.js          # Main MCP server
├── process-manager.js # Tomcat lifecycle management  
├── log-manager.js     # Log capture and querying
├── tools/             # MCP tool implementations
└── config.js          # Configuration management

📄 License

MIT