Manages Gradle-based Tomcat applications, allowing process control (start, stop, restart) and execution of Gradle commands in specified project directories
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
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
This server cannot be installed
Enables management of Gradle-based Tomcat applications with capabilities for starting, stopping, restarting processes and querying application logs.
Related MCP Servers
- AsecurityFlicenseAqualityEnables interaction with Coolify applications and resources through the Coolify API via a standardized interface, supporting application management operations such as listing, starting, stopping, restarting, and deploying.Last updated -113JavaScript
- -securityFlicense-qualityEnables comprehensive GitHub operations through natural language including file management, repository administration, issue tracking, and advanced code searching.Last updated -22,5731TypeScript
- -securityAlicense-qualityProvides tools for analyzing project structures, searching through codebases, managing dependencies, and performing file operations with advanced filtering capabilities.Last updated -511TypeScriptMIT License
- AsecurityAlicenseAqualityProvides comprehensive Git operations as tools for AI assistants and applications. This server enables AI systems to interact with Git repositories, allowing to initialize, fetch, commit, log, status, etc..Last updated -1011TypeScriptMIT License