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

1. 安装

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 .

1. 设置环境变量：

   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通用公共许可证许可。请参阅 许可证 文件以获取详细信息。