Directadmin

by omryatia

3 446 downloads Not rated yet
GitHub

About

# DirectAdmin MCP Server [![version](https://img.shields.io/badge/version-0.1.0-blue.svg)](https://github.com/omryatia/directadmin-mcp) A Model Context Protocol (MCP) server for DirectAdmin integration, allowing AI assistants to interact with DirectAdmin through natural language. ## Features - **MCP Integration**…

Explore

- MCP Integration: Connect AI assistants to DirectAdmin using the Model Context Protocol
- RESTful API: Comprehensive API for DirectAdmin management
- Server-Sent Events (SSE): Real-time communication with clients
- Tool-based Architecture: Modular design with tool-based commands
- Command-line Client: Included client for testing and scripting
- Docker Support: Easy deployment with Docker and Docker Compose

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Directadmin
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

- Python 3.12+
- DirectAdmin server with API access
- DirectAdmin login key (preferred) or username/password

1. Clone the repository:

   git clone https://github.com/omryatia/directadmin-mcp.git
cd directadmin-mcp

2. Create a virtual environment:

   python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate

3. Install dependencies:

   pip install -r requirements.txt

4. Create configuration:

   cp .gitignore.sample .gitignore
cp .env.sample .env

1. Clone the repository:

bash
git clone https://github.com/omryatia/directadmin-mcp.git
cd directadmin-mcp

2. Create configuration:
bash
cp .env.sample .env

| Variable | Description | Default |
|----------|-------------|---------|
| DA_URL | DirectAdmin server URL with port | (Required) |
| DA_USERNAME | DirectAdmin username | (Required) |
| DA_LOGIN_KEY | DirectAdmin login key | (Required) |
| PORT | Port to run the MCP server on | 8888 |
| LOG_LEVEL | Logging level (DEBUG, INFO, WARNING, ERROR) | INFO |
| DEBUG | Enable debug mode for development | false |
| SSL_VERIFY | Verify SSL certificates for DirectAdmin API calls | true |

The project includes Docker support for easy deployment:

```bash

The server exposes the following DirectAdmin operations as tools:

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "directadmin": {
            "directadmin": {
                "command": "docker",
                "url": "http://localhost:8888/sse",
                "enabled": true
            }
        }
    }
}

McpServers

{
    "directadmin": {
        "command": "docker",
        "url": "http://localhost:8888/sse",
        "enabled": true
    }
}

version

A Model Context Protocol (MCP) server for DirectAdmin integration, allowing AI assistants to interact with DirectAdmin through natural language.

Features

- MCP Integration: Connect AI assistants to DirectAdmin using the Model Context Protocol
- RESTful API: Comprehensive API for DirectAdmin management
- Server-Sent Events (SSE): Real-time communication with clients
- Tool-based Architecture: Modular design with tool-based commands
- Command-line Client: Included client for testing and scripting
- Docker Support: Easy deployment with Docker and Docker Compose

Architecture

This project implements a server that acts as a bridge between AI assistants and DirectAdmin:

┌──────────┐     ┌─────────────────┐     ┌────────────┐
│   AI     │     │  DirectAdmin    │     │ DirectAdmin│
│ Assistant├────►│  MCP Server     ├────►│   API      │
└──────────┘     └─────────────────┘     └────────────┘
      MCP                SSE                 HTTP

The server exposes DirectAdmin functionality through a tool-based interface, making it easy for AI assistants to understand and interact with DirectAdmin operations.

Prerequisites

- Python 3.12+
- DirectAdmin server with API access
- DirectAdmin login key (preferred) or username/password

Installation

Option 1: Standard Installation

1. Clone the repository:

   git clone https://github.com/omryatia/directadmin-mcp.git
cd directadmin-mcp

2. Create a virtual environment:

   python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate

3. Install dependencies:

   pip install -r requirements.txt

4. Create configuration:

   cp .gitignore.sample .gitignore
cp .env.sample .env
# Edit .env with your DirectAdmin settings

Option 2: Docker Installation

1. Clone the repository:

   git clone https://github.com/omryatia/directadmin-mcp.git
cd directadmin-mcp

2. Create configuration:

   cp .env.sample .env
# Edit .env with your DirectAdmin settings

3. Build and start with Docker Compose:

   docker-compose up -d

Configuration

Edit the .env file with your DirectAdmin credentials:

```ini

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.