AI导哈

托管平台管理API服务

Devil MCP Server 是一个通过REST API提供对devil托管平台管理工具程序化访问的解决方案，适用于AI助手和MCP兼容客户端管理网站、数据库、DNS记录等服务。

  • by devil-imps
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 devil-imps/devil-mcp

使用说明

魔鬼MCP服务器

A. 模型上下文协议（MCP）服务器 通过安全的REST API接口提供对魔鬼托管平台管理工具的编程访问。

描述

Devil MCP Server是一个全面的解决方案，弥合了人工智能助手和Devil托管平台管理之间的差距。它由两个主要部分组成：

  • 魔鬼API：基于FastAPI的REST API，通过UNIX域套接字与devil命令行工具通信
  • 魔鬼MCP服务器：MCP服务器包装器，将Devil API功能暴露给AI助手和其他兼容MCP的客户端

这允许AI助手通过标准化协议管理托管服务，包括网站、数据库、DNS记录、SSL证书、电子邮件帐户等。

安装

先决条件：

  • Python 3.11+
  • 通过位于/var/run/devil2.sock的UNIX域套接字提供的魔鬼服务（在同一主机上运行）
  • 要在您的环境中配置的有效API密钥

  1. 克隆存储库

    git clone --recurse-submodules https://github.com/devil-imps/devil-mcp.git
cd devil-mcp

  2. 安装

    a） 使用 紫外线的 （推荐）

    不幸的是，目前魔鬼服务器上没有安装UV，您可以使用 莉莉丝：魔鬼的包裹管理员 安装UV。

    uv sync

    b） 使用PIP可编辑安装

    # Create and activate a virtual environment
virtualenv .venv
source .venv/bin/activate

# Install dependencies
pip install -e src/devil_api
pip install -e .

  3. 设置环境变量：

    cp .env.example .env

    编辑 .env 并配置您的设置：

    # Required API KEY, put here something strong
DEVIL_API_KEY=your_devil_api_key_here

# Devil MCP Server Configuration
DEVIL_MCP_HOST=0.0.0.0
# Change port number to your reserved port, use `devil port add tcp random devil-mcp` to reserve random one
DEVIL_MCP_PORT=8000

# Optional configurations
READ_ONLY_MODE=false
RATE_LIMIT_ENABLED=false
RATE_LIMIT_MAX_REQUESTS=60
RATE_LIMIT_WINDOW_MINUTES=1

# Logging
LOG_LEVEL=INFO

用法

启动服务器

使用紫外线：

# Installed script
uv run devil-mcp

# Or standalone script
uv run python run_server.py

使用virtualenv：

# Activate a virtual environment
source .venv/bin/activate

# Installed script
devil-mcp

# Or standalone script
python run_server.py

配置选项

服务器可以通过环境变量进行配置：

# Server Configuration
export DEVIL_MCP_HOST="0.0.0.0"        # Bind to all interfaces
export DEVIL_MCP_PORT="8080"           # Custom port
export DEVIL_API_KEY="your-api-key"    # Required API key

# Security Options
export READ_ONLY_MODE="true"           # Enable read-only mode
export RATE_LIMIT_ENABLED="true"       # Enable rate limiting
export RATE_LIMIT_MAX_REQUESTS="100"   # Max requests per window
export RATE_LIMIT_WINDOW_MINUTES="5"   # Rate limit window

# Logging
export LOG_LEVEL="DEBUG"               # Set log level

连接到AI助手和IDE

Devil MCP服务器可以与支持模型上下文协议（MCP）的各种AI助手和开发环境集成。

Visual Studio Code

使用MCP扩展

  1. 安装MCP扩展 VS代码
  2. 配置服务器 在VS代码设置或MCP配置文件中：
{
  "servers": {
    "devil-mcp": {
      "type": "http",
      "url": "http://domain.tld:8000/mcp",
      "headers": {
        "Authorization": "Bearer your_devil_api_key_here"
      }
    }
  }
}

克劳德桌面

看 Claude桌面快速入门

基于网络的人工智能助手

对于支持HTTP MCP连接的基于web的AI助手：

{
  "mcp_servers": [
    {
      "name": "devil-mcp",
      "type": "http",
      "url": "http://domain.tld:8000/mcp",
      "auth": {
        "type": "bearer",
        "token": "your_devil_api_key_here"
      }
    }
  ]
}

贡献

欢迎投稿、问题和功能请求！请随时查看问题页面或提交拉取请求。

许可证

本项目根据GNU AFFERO通用公共许可证许可。请参阅 许可证 文件以获取详细信息。

相关 MCP