WildFly Server Management MCP Server

Cloud PlatformsJava

Interact with WildFly servers using natural language through AI integration

Available Tools

serverStatus

Get the current status of the WildFly server including running state, uptime, and resource usage

deployApplication

Deploy an application to the WildFly server

applicationPathruntimeNameenabled

undeployApplication

Undeploy an application from the WildFly server

deploymentName

listDeployments

List all applications deployed on the WildFly server

configureDatasource

Configure a new datasource on the WildFly server

namejndiNameconnectionUrldriverNameusernamepassword

checkLogs

Retrieve and analyze server logs

lineslevelsince

The WildFly MCP server enables AI-powered management and monitoring of WildFly application servers through natural language interactions. It allows developers and administrators to query server status, deploy applications, configure settings, and troubleshoot issues using conversational language rather than complex management commands. This integration bridges the gap between WildFly's powerful Java EE/Jakarta EE capabilities and modern AI assistants, making server management more accessible and efficient. The project includes both a standalone MCP server and a complete chat bot solution for comprehensive WildFly server management.

Overview

The WildFly MCP server provides a Model Context Protocol implementation that allows AI assistants to interact with and manage WildFly application servers using natural language. This integration enables you to monitor, configure, and troubleshoot WildFly servers through conversational interfaces.

Installation

There are multiple ways to install and use the WildFly MCP server:

Option 1: Using Container Images

The simplest way to get started is using the pre-built container images:

# Pull the WildFly MCP server image
docker pull quay.io/wildfly-extras/wildfly-mcp-server:latest

# Run the container
docker run -p 9990:9990 quay.io/wildfly-extras/wildfly-mcp-server:latest

Option 2: Building from Source

To build from source:

Clone the repository:

git clone https://github.com/wildfly-extras/wildfly-mcp.git
cd wildfly-mcp

Build the project:

cd wildfly-mcp-server
mvn clean install

Run the server:

java -jar target/wildfly-mcp-server-runner.jar

Integration with AI Assistants

To integrate with your AI assistant, add the following configuration:

"mcpServers": {
  "wildfly-server": {
    "command": "java",
    "args": [
      "-jar",
      "PATH_TO_WILDFLY_MCP/wildfly-mcp-server-runner.jar"
    ]
  }
}

Replace PATH_TO_WILDFLY_MCP with the actual path to your WildFly MCP server JAR file.

Usage

Once integrated, you can interact with your WildFly server using natural language commands through your AI assistant. Here are some examples:

"What is the status of my WildFly server?"
"Deploy application my-app.war to the server"
"Show me the current memory usage of the server"
"List all deployed applications"
"Check the server logs for errors"
"Configure a new datasource for my application"

Advanced Configuration

Connecting to Remote WildFly Servers

By default, the MCP server connects to a local WildFly instance. To connect to a remote server:

java -jar wildfly-mcp-server-runner.jar --host=remote-server --port=9990 --username=admin --password=password

Using the WildFly Chat Bot

For a complete solution that includes both the MCP server and a chat interface:

Build the chat bot:
```
cd wildfly-chat-bot
mvn clean install
```

Run the chat bot:

java -jar target/wildfly-chat-bot-runner.jar

OpenShift Deployment

For deploying on OpenShift, refer to the container-images directory in the repository which contains deployment examples and instructions.

Troubleshooting

Connection Issues: Ensure your WildFly server is running and the management interface is accessible
Authentication Failures: Verify your credentials if connecting to a secured WildFly instance
Protocol Errors: Make sure you're using the correct protocol version in your MCP client

For more detailed information, visit the GitHub repository.