基础设施管理服务器

Ansible MCP服务器

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

特性

• 58基础设施管理工具

  • 合理的剧本创作和执行
  • 地形基础设施配置
  • 硬件发现和库存
  • 安全扫描和审计
  • 从目录部署服务
  • 网络设备管理
  • 环境管理（测试/阶段/生产）

• AI优化设计

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

• 与跨平台支持

  • Linux服务器部署
  • 通过SSE代理支持Windows客户端
  • 远程服务器管理

快速开始

先决条件

• Node.js 16+
• 答案2.9+
• 地形（可选）

安装

# Clone the repository
git clone https://github.com/yourusername/ansible-mcp-server.git
cd ansible-mcp-server

# Install dependencies
npm install

# Copy and configure environment
cp .env.example .env
# Edit .env with your settings

# Run the server
npm start

适用于克劳德桌面

添加到您的Claude Desktop配置中：

{
  "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 Desktop，请使用SSE代理：

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

看 Windows安装指南 了解详情。

可用工具

Ansible工具

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

基础设施工具

• hardware-scan -全面的硬件发现
• storage-analysis -存储和SMART健康分析
• network-interfaces -网络适配器发现
• discover-proxmox -发现Proxmox虚拟机
• generate-inventory -创建可靠的库存

安全工具

• 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 -环保部署

文档

• 集成指南
• 硬件清单指南
• 克劳德剧本修复
• 模块化工具系统

测试

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

# Run tests in development environment
npm test

# Test specific environments
npm run test:dev      # Development
npm run test:qa       # QA
npm run test:staging  # Staging
npm run test:prod     # Production

# Verbose output for debugging
npm run test:verbose

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

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

看 测试指南 了解详细信息。

贡献

1. 分叉存储库
2. 创建功能分支(git checkout -b feature/amazing-feature)
3. 提交您的更改(git commit -m 'Add amazing feature')
4. 推到分支(git push origin feature/amazing-feature)
5. 打开拉取请求

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

致谢

• 专为配合使用而设计 克劳德 和其他AI助手
• 使用 模型上下文协议
• 由...驱动 安塞波 和 地形