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)

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

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

Manual 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

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

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

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

Enables management of Gradle-based Tomcat applications with capabilities for starting, stopping, restarting processes and querying application logs.

Related MCP Servers

Coolify MCP Server
StuMason
A
security
F
license
A
quality
Enables 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 -
11
3
JavaScript
GitHub MCP Server
tuanle96
-
security
F
license
-
quality
Enables comprehensive GitHub operations through natural language including file management, repository administration, issue tracking, and advanced code searching.
Last updated -
22,573
1
TypeScript
Project Explorer MCP Server
MausRundung362
-
security
A
license
-
quality
Provides tools for analyzing project structures, searching through codebases, managing dependencies, and performing file operations with advanced filtering capabilities.
Last updated -
51
1
TypeScript
MIT License
mcp-git
ver0-project
A
security
A
license
A
quality
Provides 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 -
10
11
TypeScript
MIT License

View all related MCP servers

Gradle Tomcat MCP Server