MCP Ansible Drupal

MCP运维云端

提供方 webfer

运维云端 未标注 无需鉴权 社区 / 第三方 Claude DesktopClaude

MCP-Ansible-Drupal是一个智能自动化服务器,通过Ansible实现Drupal部署工作流的自动化,支持从初始设置到生产发布的完整生命周期管理,并通过自然语言交互进行操作。

一句话选型结论

按资料字段整理

MCP Ansible Drupal 属于运维云端类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Claude Desktop、Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 8 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量8暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

自动化部署TypeScript本地部署Drupal管理Ansible集成DevOps工具自然语言交互

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 8 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 8 个工具,职责相对集中,接入后不容易误操作。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Ansible Drupal当前 8 未标注 未标注 无 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方webfer上游标注的维护方 webfer
分类运维云端本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

17.2 KB
来自项目仓库与上游目录的原文,未做删改

🚀 MCP Ansible Drupal

> 使用Ansible自动化Drupal部署工作流的模型上下文协议(MCP)服务器

MCP Ansible Drupal 是一个智能自动化服务器,将AI助手与Ansible驱动的Drupal部署连接起来。它提供了一套全面的工具,通过自然语言交互来管理从初始设置到生产发布的整个部署生命周期。

> 🔗 与无缝协作 醉酒 -Drupal的基于Ansible的部署框架。这个MCP服务器提供了一个智能界面,通过人工智能助手控制DrupAnsible剧本,使DevOps工作流程变得对话式和可访问。


📋 目录

  • ✨ 特性
  • 🎯 什么是MCP?
  • 🏗️ 建筑
  • 📦 安装
  • 🔧 配置
  • 🎮 可用工具
  • 📚 使用示例
  • 🔐 安全
  • 🛠️ 发展
  • 📄 许可证

✨ 特性

🔄 部署管理

  • 安装/更新部署:对临时/生产执行初始安装或增量更新
  • 零停机释放:利用Ansistrano实现具有回滚功能的无缝部署
  • 资产同步:主题、图像和静态文件的可选资产部署
  • 数据库操作:自动导入、备份和更新数据库

🔐 保险库安全

  • 加密配置:用于安全凭证管理的Ansible Vault集成
  • 加密/解密工具:直接从您的AI助手进行安全的vault文件管理
  • 环境隔离:用于暂存和生产环境的单独vault文件

📊 监控和日志

  • 实时部署流媒体:部署执行期间的实时进度更新
  • 日志管理:自动日志轮换(保留最后3次部署)
  • 部署历史记录:查询最近的部署日志以进行故障排除

🎛️ 工作流程自动化

  • 存储库克隆:自动DrupAnsible存储库设置
  • 配置转移:将Ansible文件智能移动到项目根目录
  • 清理作业:自动删除临时文件和目录

🤖 AI原生设计

  • 自然语言控制:通过对话执行复杂的部署工作流
  • 交互式确认:破坏性操作的安全提示
  • 上下文感知响应:每一步都有详细的反馈

🎯 什么是MCP?

这 模型上下文协议(MCP) 是一个开放标准,使AI助手(如Claude、ChatGPT)能够安全地与外部工具和数据源进行交互。将其视为一个通用适配器,让AI模型:

  • 🔧 执行系统操作
  • 📁 访问文件系统
  • 🌐 与API交互
  • 🚀 触发部署管道

该项目实现了一个专门为Drupal/Ansible工作流设计的MCP服务器,使DevOps任务具有对话性和可访问性。


🏗️ 建筑```

┌─────────────────────────────────────────────────────────────┐
│ AI Assistant (Claude) │
│ Natural Language Interface │
└────────────────────────┬────────────────────────────────────┘
│ MCP Protocol
┌────────────────────────▼────────────────────────────────────┐
│ MCP-Ansible-Drupal Server │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ Tools Layer │ │
│ │ • cloneRepository • validateDeploy │ │
│ │ • ansibleSetup • executeDeployment │ │
│ │ • decryptVaultFile • encryptVaultFile │ │
│ │ • getDeploymentLogs • ansibleCleanup │ │
│ └──────────────────────────────────────────────────────┘ │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ Helpers Layer │ │
│ │ • confirmFirstDeployment • runAnsible │ │
│ │ • generateSkipTags • resolveProjectPaths │ │
│ └──────────────────────────────────────────────────────┘ │
└────────────────────────┬────────────────────────────────────┘
│ Shell Commands
┌────────────────────────▼────────────────────────────────────┐
│ Ansible Playbooks │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ • stage-deploy.yml • live-deploy.yml │ │
│ │ • rollback.yml • Ansistrano tasks │ │
│ └──────────────────────────────────────────────────────┘ │
└────────────────────────┬────────────────────────────────────┘
│ SSH/rsync
┌────────────────────────▼────────────────────────────────────┐
│ Drupal Application Server │
│ (Staging / Production Environment) │
└─────────────────────────────────────────────────────────────┘


### 关键组件

#### **1.服务器层** (`src/server.ts`)

- MCP协议处理程序
- 工具注册和布线
- 请求/响应管理
- 交互式确认流程

#### **2.工具层** (`src/tools/`)

- **部署工具**: `executeDeployment.ts`, `validateDeployTool.ts`
- **Vault工具**: `decryptVaultTool.ts`, `encryptVaultTool.ts`
- **设置工具**: `cloneRepositoryTool.ts`, `ansibleSetupTool.ts`
- **实用工具**: `getDeploymentLogs.ts`, `generateSkipTags.ts`

#### **3.辅助层** (`src/helpers/`)

- 部署确认工作流
- 可执行的命令
- 路径解析和验证

#### **4.可靠的集成**

- **战术**:位于 `ansible/core/` 目录
- **库存**:中的环境特定配置 `ansible/core/inventories/`
- **Vault文件**:每个环境的加密凭据

______________________________________________________________________

## 📦 安装

### 先决条件

- **Node.js** 18+
- **TypeScript** 5.2+
- **安塞波** 2.x
- **Git**

### 快速开始

> ⭐ **推荐**:通过NPM从以下位置安装 npmjs.com/package/@webfer/mcp-ansible-drupal 以获得最佳体验和自动更新。```bash
# 1. Install the package (RECOMMENDED)
npm install @webfer/mcp-ansible-drupal

# 2. Alternative: Build from source (for development only)
git clone https://github.com/webfer/MCP-Ansible-Drupal.git
cd MCP-Ansible-Drupal
npm install
npm run build

# 3. Configure your MCP client
# Add to your MCP settings (e.g., Claude Desktop config):

Claude桌面配置 (claude_desktop_config.json):```json
{
"mcpServers": {
"mcp-ansible-drupal": {
"command": "node",
"args": ["/path/to/MCP-Ansible-Drupal/dist/server.js"],
"cwd": "/path/to/your/drupal-project"
}
}
}


______________________________________________________________________

## 🔧 配置

### 项目结构要求

你的Drupal项目应该有这样的结构:```
your-drupal-project/
├── ansible/
│   ├── core/
│   │   ├── stage-deploy.yml
│   │   ├── live-deploy.yml
│   │   └── inventories/
│   │       ├── stage/
│   │       │   ├── inventory.yml
│   │       │   └── group_vars/
│   │       │       ├── server.yml (encrypted)
│   │       │       └── deploy_vars.yml
│   │       └── live/
│   └── tmp/
│       └── logs/
├── vault_pass.txt (git-ignored!)
├── composer.json
└── web/ (Drupal root)

Vault密码文件

创建 vault_pass.txt 在项目根目录中:```bash
echo "your-secure-password" > vault_pass.txt
chmod 600 vault_pass.txt


**⚠️ 重要**:添加到 `.gitignore`!

### Ansible Vault文件

加密敏感数据:```bash
ansible-vault encrypt ansible/core/inventories/stage/group_vars/server.yml \
--vault-password-file vault_pass.txt

🎮 可用工具

1️⃣ 存储库设置

cloneRepository

克隆DrupAnsible基础存储库以引导您的项目。

参数:

  • repoUrl (字符串):存储库URL(默认值: https://github.com/webfer/drupansible.git)

提示示例(正常工作):```
Clone the DrupAnsible repository to get started with the setup.


______________________________________________________________________

#### `ansibleSetup`

将Ansible配置文件从临时目录移动到项目根目录。

**参数:** 无

**提示示例(正常工作):**```
Run ansible setup to configure the project files.

ansibleCleanup

安装后删除临时文件和目录。

参数: 无

提示示例(正常工作):```
Clean up the temporary deployment files.


______________________________________________________________________

### 2️⃣ **部署操作**

#### `validateDeploy`

执行前验证部署配置。

**参数:**

- `environment` (字符串): `stage` | `live`
- `action` (字符串): `install` | `update`
- `withAssets` (布尔值):包括资产同步

**提示示例(正常工作):**```
Validate the deployment configuration for staging environment with install action.

executeDeployment

执行Ansible部署手册。

参数:

  • environment (字符串): stage · live · production
  • action (字符串): install | update
  • withAssets (boolean):部署资产(默认值: false)
  • confirmAnswer (字符串): yes | no (用于安装确认)

提示示例(正确工作):```
Run initial deployment to staging environment.
``````
Execute update deployment to production with assets included.


**安装流量:**```
User: "Deploy fresh install to stage"
MCP:  "⚠️ This will overwrite existing code. Continue? (yes/no)"
User: "yes"
MCP:  "✅ Proceeding with deployment..."
[Live deployment logs stream here]

3️⃣ 保管库管理

decryptVaultFile

解密Ansible Vault文件以供查看/编辑。

参数:

  • environment (字符串): stage | live

提示示例(正常工作):```
Decrypt the stage server vault file so I can review the configuration.


______________________________________________________________________

#### `encryptVaultFile`

修改后重新加密Ansible Vault文件。

**参数:**

- `environment` (字符串): `stage` | `live`

**提示示例(正常工作):**```
Encrypt the stage vault file after my changes.

4️⃣ 监控

getDeploymentLogs

检索最近的部署日志。

参数:

  • lines (number):要返回的行数(默认值:50)

提示示例(正常工作):```
Show me the last 100 lines of the deployment logs.


______________________________________________________________________

## 📚 使用示例

### 完整工作流示例```
User: "Set up a new Drupal deployment environment"

1. MCP clones DrupAnsible repository
2. MCP moves configuration files to project root
3. MCP cleans up temporary directories

User: "Configure staging credentials"

4. MCP decrypts stage vault file
5. [User edits file with credentials]
6. MCP encrypts vault file

User: "Deploy to staging"

7. MCP validates configuration
8. MCP asks for confirmation
9. User confirms "yes"
10. MCP executes deployment with live streaming
11. Deployment completes successfully

User: "Show deployment logs"

12. MCP displays recent deployment logs

更新部署```

User: "Update staging with latest code changes"

MCP: "✅ Executing update deployment..."
[Streaming logs]:
🔸 TASK [Rsync code to server]
🟡 changed: [stage]
🔸 TASK [Import configuration]
🟡 changed: [stage]
🔸 TASK [Run database updates]
🟡 changed: [stage]
🔸 TASK [Clear cache]
🟡 changed: [stage]
✅ Deployment completed: 45 tasks, 18 changes


______________________________________________________________________

## 🔐 安全

### 最佳实践

1. **从不提交保管库密码**```bash
echo "vault_pass.txt" >> .gitignore
  1. 使用强保管库密码```bash
    openssl rand -base64 32 > vault_pass.txt

1. **定期轮换保管库密码**```bash
ansible-vault rekey group_vars/server.yml
  1. 限制MCP服务器权限
  • 以最低用户权限运行
  • 限制文件系统访问
  • 部署时使用SSH密钥身份验证
  1. 审核部署日志
  • 日志存储在 ansible/tmp/logs/
  • 安全事件审查
  • 自动旋转(保持最后3个)

🛠️ 发展

项目结构```

MCP-Ansible-Drupal/
├── src/
│ ├── server.ts # MCP server entry point
│ ├── tools/ # MCP tool implementations
│ │ ├── executeDeployment.ts
│ │ ├── validateDeployTool.ts
│ │ ├── decryptVaultTool.ts
│ │ ├── encryptVaultTool.ts
│ │ └── ...
│ ├── helpers/ # Utility functions
│ │ ├── confirmFirstDeployment.ts
│ │ ├── runAnsible.ts
│ │ └── ...
│ ├── prompts/ # User interaction prompts
│ └── types/ # TypeScript type definitions
├── ansible/ # Ansible playbooks & config
│ └── core/
│ ├── stage-deploy.yml
│ ├── live-deploy.yml
│ ├── inventories/
│ └── tasks/
├── dist/ # Compiled JavaScript
├── package.json
├── tsconfig.json
└── README.md


### 建筑```bash
# Compile TypeScript
npm run build

# Watch mode for development
npm run watch

# Run the server
npm start

添加新工具

  1. 在中创建工具文件 src/tools/:```typescript
    export class MyCustomTool {
    name = 'myCustomTool';
    description = 'Does something useful';

async run(args: any) {
// Tool implementation
return { content: [{ type: 'text', text: 'Result' }] };
}
}


2. 注册 `src/server.ts`:```typescript
import { MyCustomTool } from './tools/myCustomTool.js';

server.setRequestHandler(ListToolsRequestSchema, async () => ({
tools: [
{
name: 'myCustomTool',
description: 'Does something useful',
inputSchema: {
/* JSON Schema */
},
},
],
}));

测试```bash

Run tests (when available)

npm test

Manual testing with Claude Desktop

Check logs in:

- macOS: ~/Library/Logs/Claude/mcp*.log

- Windows: %APPDATA%\Claude\logs\mcp*.log

```


🤝 贡献

欢迎投稿!拜托:

  1. 复刻仓库
  2. 创建要素分支(git checkout -b feature/amazing-feature)
  3. 提交更改(git commit -m 'Add amazing feature')
  4. 推送到分支(git push origin feature/amazing-feature)
  5. 打开拉取请求

代码规范

  • 遵循现有的TypeScript约定
  • 为公共API添加JSDoc注释
  • 包括错误处理
  • 更新README以获取新功能

📄 许可证

MIT许可证-请参阅 许可证 详细信息文件

由...开发 费尔南多·卡斯特罗(韦弗饰)


🔗 链接

  • 📦 npm包
  • 🐙 GitHub存储库
  • 📖 模型上下文协议文档
  • 🌐 猪跑
  • 🔧 安塞波
  • 🚀 左

💬 支持

  • 🐛 问题: GitHub问题
  • 💡 讨论: GitHub讨论
  • 📧 联系: 领英

⭐ 如果你觉得这个项目有用,就把它当明星吧!

由...制作❤️ Drupal和DevOps社区

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
MCP Ansible Drupal 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

MCP Ansible Drupal 怎么在 Claude Desktop、Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

MCP Ansible Drupal 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

MCP Ansible Drupal 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

MCP Ansible Drupal 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

MCP Ansible Drupal 能提供哪些能力?

资料显示约 8 个工具;能力标签包括 自动化部署、自然语言交互、TypeScript、Claude。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。