Manages Gradle-based Tomcat applications, allowing process control (start, stop, restart) and execution of Gradle commands in specified project directories
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Gradle Tomcat MCP Serverget recent logs with level ERROR from the last hour"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 runworking_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 stopgradle_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 fromsource(optional): Filter by source (stdout, stderr)
clear_logs
Clear log buffer and files
confirm(required): Must be true to confirm
Architecture
License
MIT