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
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
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 -117JavaScript
- -securityAlicense-qualityProvides tools for analyzing project structures, searching through codebases, managing dependencies, and performing file operations with advanced filtering capabilities.Last updated -291TypeScriptMIT 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 -105TypeScriptMIT License
- -securityFlicense-qualityAn open-source Model Context Protocol application management platform that allows users to create applications from GitHub repositories with automatic information extraction and database integration.Last updated -19TypeScript