Ansible MCP 服务器

一个模型上下文协议（MCP）服务器，使AI助手能够使用Ansible和Terraform管理基础设施。

功能

• 58种基础设施管理工具

  • Ansible playbook的创建与执行
  • Terraform基础设施供应
  • 硬件发现与清单
  • 安全扫描与审计
  • 从目录部署服务
  • 网络设备管理
  • 环境管理（测试/预发布/生产）

• AI优化设计

  • 接受YAML字符串的灵活playbook创建
  • 全面的错误处理
  • 会话间上下文持久化
  • 服务动态工具加载

• 跨平台支持

  • Linux服务器部署

• 通过SSE代理支持Windows客户端

• 远程服务器管理

快速开始

前提条件

• Node.js 16+
• Ansible 2.9+
• Terraform（可选）

安装

# 克隆仓库
git clone https://github.com/yourusername/ansible-mcp-server.git
cd ansible-mcp-server

# 安装依赖
npm install

# 复制并配置环境
cp .env.example .env
# 使用您的设置编辑 .env

# 启动服务器
npm start

对于Claude桌面

添加到您的Claude桌面配置中：

{
  "mcpServers": {
    "ansible": {
      "command": "node",
      "args": ["/path/to/ansible-mcp-server/src/index.js"],
      "env": {
        "PROXMOX_HOST": "your-proxmox-host",
        "PROXMOX_USER": "root@pam",
        "PROXMOX_PASSWORD": "your-password"
      }
    }
  }
}

Windows用户

对于Windows Claude桌面，请使用SSE代理：

1. 将MCP服务器部署到Linux主机上
2. 在Linux主机上运行SSE服务器
3. 配置Claude桌面以使用Windows客户端

详情请参阅Windows安装指南。

可用工具

Ansible工具

• create-playbook-flexible - 使用YAML字符串或对象创建playbook
• ansible-playbook - 执行Ansible playbook
• ansible-task - 执行临时Ansible任务
• ansible-role - 执行Ansible角色
• validate-playbook - 验证playbook语法
• create-role-structure - 生成Ansible角色目录

基础设施工具

• hardware-scan - 综合硬件发现
• storage-analysis - 存储和SMART健康分析
• network-interfaces - 网络适配器发现
• discover-proxmox - 发现Proxmox虚拟机
• generate-inventory - 创建Ansible清单

安全工具

• security-quick-scan - 快速安全评估
• security-scan-ports - 端口扫描
• security-check-passwords - 密码策略审核
• security-audit-accounts - 用户账户审核
• security-check-ssh - SSH配置审核

服务管理

• browse-services - 浏览服务目录
• deploy-service - 从目录部署服务
• list-environments - 列出部署环境
• deploy-to-environment - 使用环境保护进行部署

文档

• 集成指南
• 硬件清单指南
• Claude Playbook修复
• 模块化工具系统

测试

运行全面的功能测试套件：

# 在开发环境中运行测试
npm test

# 测试特定环境
npm run test:dev      # 开发
npm run test:qa       # 质量保证
npm run test:staging  # 预发布
npm run test:prod     # 生产

# 调试时的详细输出
npm run test:verbose

我们的功能测试验证了完整的VM生命周期工作流程，包括：

• 从Proxmox模板创建VM
• 服务安装（Jenkins等）
• 服务验证和管理
• VM删除和清理
• MCP上下文管理

详情请参阅测试指南。

贡献

1. 分叉仓库
2. 创建您的功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m '添加神奇功能'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 打开Pull Request

许可

本项目根据MIT许可发布 - 详情见LICENSE文件。

致谢

• 为与Claude和其他AI助手一起使用而构建
• 使用模型上下文协议
• 由Ansible和Terraform提供支持