Gradle Tomcat 服务器管理工具

一个用于管理基于Gradle的Tomcat应用程序的MCP服务器,提供进程管理、日志查询和实时监控功能。

  • by lkb2k
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 lkb2k/mcp-gradle

使用说明

Gradle Tomcat MCP服务器

用于管理具有日志查询功能的基于Gradle的Tomcat应用程序的模型上下文协议(MCP)服务器。

特性

  • 流程管理:通过Gradle启动、停止、重启和监视Tomcat进程
  • 日志管理:通过过滤捕获、存储和查询应用程序日志
  • 实时监控:流日志和进程状态更新
  • MCP集成:与Claude和其他MCP客户完全集成

安装

全局安装(推荐)

npm install -g mcp-gradle-tomcat

本地安装

npm install mcp-gradle-tomcat

来源

git clone https://github.com/your-username/mcp-gradle-tomcat.git
cd mcp-gradle-tomcat
npm install

快速开始

1.添加到Claude配置

将其添加到您的Claude配置文件中(~/.claude/config.json):

{
  "mcpServers": {
    "gradle-tomcat": {
      "command": "mcp-gradle-tomcat",
      "env": {
        "GRADLE_WORKING_DIR": "/path/to/your/gradle/project"
      }
    }
  }
}

2.与Claude一起使用

配置后,您可以在Claude中使用这些命令:

  • “启动Tomcat” -启动您的Gradle应用程序
  • “停止Tomcat” -优雅地停止正在运行的应用程序
  • “获取Tomcat状态” -显示流程状态和正常运行时间
  • “获取最近的日志” -通过筛选检索应用程序日志
  • “重新启动Tomcat” -停止和启动应用程序

手动使用

直接执行

# Set your project directory
export GRADLE_WORKING_DIR="/path/to/your/gradle/project"

# Run the MCP server
mcp-gradle-tomcat

测试工具

# Test individual tools
npm test

配置

可以通过环境变量设置配置:

  • GRADLE_WORKING_DIR:Gradle命令的工作目录(默认:当前目录)
  • GRADLE_COMMAND:要运行的Gradle命令(默认值:appRun)
  • TOMCAT_PORT:预期的Tomcat端口(默认值:8080)
  • MAX_LOG_BUFFER_SIZE:内存中的最大日志条目数(默认值:1000)
  • LOG_DIR:日志文件目录(默认:./logs)

可用工具

start_tomcat

通过Gradle启动Tomcat

  • gradle_command (可选):运行Gradle命令
  • working_directory (可选):工作目录

stop_tomcat

终止Tomcat进程

  • force (可选):使用SIGKILL强制终止

restart_tomcat

停止并启动Tomcat

  • force (可选):停止时强制终止
  • gradle_command (可选):Gradle命令用于重新启动

get_tomcat_status

检查Tomcat进程状态

  • 无参数

get_logs

检索日志条目

  • lines (可选):最近的日志行数(默认值:100)
  • level (可选):最低日志级别(调试、信息、警告、错误)
  • since (可选):要过滤的ISO 8601时间戳
  • source (可选):按源筛选(stdout、stderr)

clear_logs

清除日志缓冲区和文件

  • confirm (必填):必须为真才能确认

建筑

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

许可证

麻省理工学院