Overview
What is Directadmin?
Directadmin is a Model Context Protocol (MCP) server that bridges AI assistants with the DirectAdmin web hosting control panel. It translates natural-language requests into DirectAdmin API calls, enabling automated server management through a tool-based interface.
How to use Directadmin?
Clone the repository, configure your DirectAdmin credentials in a .env file (DirectAdmin URL, username, and login key), then start the server via python main.py (SSE mode) or python server.py (simple mode). A bundled command-line client (python client.py) can be used for testing and scripting. Docker Compose deployment is also supported.
Key features of Directadmin
- MCP integration for AI assistant connectivity
- RESTful API with Server-Sent Events (SSE)
- Tool-based architecture with modular commands
- DirectAdmin version, update, and security management
- Command-line client and Docker deployment support
Use cases of Directadmin
- Query DirectAdmin status, version, and system package updates
- Execute server actions like restarting DirectAdmin
- View and update security.txt content
- Manage update channels and test system updates
FAQ from Directadmin
What prerequisites are needed?
Python 3.12+, a DirectAdmin server with API access, and either a DirectAdmin login key (preferred) or username/password credentials.
How do I configure Directadmin credentials?
Edit the .env file with your DirectAdmin server URL (DA_URL), username (DA_USERNAME), and login key (DA_LOGIN_KEY). The server runs on port 8888 by default.
How do I start the Directadmin server?
Use python main.py for the FastAPI SSE server or python server.py for the simple MCP server. Both start on the configured port.
What tools does Directadmin expose?
System management (api_restart, api_ping), version control (api_get_version, api_version_update, api_change_update_channel), system updates, and security.txt operations.
How can I connect an AI assistant to Directadmin?
Point your AI assistant’s MCP client to http://your-server:8888/sse to enable querying, command execution, and real-time updates.
