Gradle Tomcat MCP Server

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

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

Related MCP server: Sectional MCP Panel

Installation

Global Installation (Recommended)

Local Installation

From Source

Quick Start

1. Add to Claude Configuration

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

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

Manual Usage

Direct Execution

Testing Tools

Configuration

Configuration can be set via environment variables:

• GRADLE_WORKING_DIR: Working directory for Gradle commands (default: current directory)

• GRADLE_COMMAND: Gradle command to run (default: appRun)

• TOMCAT_PORT: Expected Tomcat port (default: 8080)

• MAX_LOG_BUFFER_SIZE: Maximum log entries in memory (default: 1000)

• LOG_DIR: Directory for log files (default: ./logs)

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

Architecture

License

MIT