Сервер MCP Ansible

Сервер Model Context Protocol (MCP) для автоматизации Ansible. Этот сервер позволяет помощникам ИИ взаимодействовать с Ansible, выполнять сценарии, управлять инвентарем и выполнять другие операции Ansible напрямую.

Функции

Запуск Ansible Playbooks : выполнение Ansible Playbooks с поддержкой таких параметров, как инвентарь, дополнительные переменные, теги и ограничения.
Список инвентаря : просмотр хостов и групп из файла инвентаря Ansible
Проверка синтаксиса : проверка синтаксиса Ansible playbook без выполнения
Список задач : предварительный просмотр задач, которые будут выполнены в соответствии с планом действий.
Доступ к инвентарю по умолчанию : доступ к файлу инвентаря Ansible по умолчанию через API ресурсов.

Требования

Node.js 18 или выше
npm или пряжа
Ansible установлен и находится в PATH
@modelcontextprotocol/sdk (устанавливается автоматически)

Установка

1. Клонировать репозиторий

git clone https://github.com/your-username/mcp-ansible.git
cd mcp-ansible

2. Установка зависимостей

npm install

3. Сборка сервера

npm run build

4. Настройте параметры MCP

Добавьте сервер Ansible MCP в файл конфигурации настроек MCP.

Для VSCode с расширением Claude:

Отредактируйте файл ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

Для приложения Claude Desktop:

macOS: Измените ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: Измените %APPDATA%\Claude\claude_desktop_config.json
Linux: Измените ~/.config/Claude/claude_desktop_config.json

Добавьте в раздел mcpServers следующее:

{
  "mcpServers": {
    "ansible": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-ansible/build/index.js"],
      "env": {}
    }
  }
}

Обязательно замените /absolute/path/to/mcp-ansible на фактический путь к вашей установке.

Примеры использования

После установки и настройки сервер MCP предоставляет следующие инструменты помощнику на основе искусственного интеллекта:

1. Запустите план действий

<use_mcp_tool>
<server_name>ansible</server_name>
<tool_name>run_playbook</tool_name>
<arguments>
{
  "playbook": "/path/to/your/playbook.yml",
  "inventory": "/path/to/inventory.ini",
  "extraVars": {
    "var1": "value1",
    "var2": "value2"
  },
  "tags": "setup,configure",
  "limit": "webservers"
}
</arguments>
</use_mcp_tool>

2. Список инвентаря

<use_mcp_tool>
<server_name>ansible</server_name>
<tool_name>list_inventory</tool_name>
<arguments>
{
  "inventory": "/path/to/inventory.ini"
}
</arguments>
</use_mcp_tool>

3. Проверьте синтаксис Playbook

<use_mcp_tool>
<server_name>ansible</server_name>
<tool_name>check_syntax</tool_name>
<arguments>
{
  "playbook": "/path/to/your/playbook.yml"
}
</arguments>
</use_mcp_tool>

4. Перечислите задачи в книге действий

<use_mcp_tool>
<server_name>ansible</server_name>
<tool_name>list_tasks</tool_name>
<arguments>
{
  "playbook": "/path/to/your/playbook.yml"
}
</arguments>
</use_mcp_tool>

5. Доступ к ресурсу инвентаря по умолчанию

<access_mcp_resource>
<server_name>ansible</server_name>
<uri>ansible://inventory/default</uri>
</access_mcp_resource>

Разработка

Структура проекта

mcp-ansible/
├── src/
│   ├── index.ts                  # Main entry point
│   └── ansible-mcp-server/       
│       └── index.ts              # Ansible MCP server implementation
├── package.json                  # Project configuration and dependencies
├── tsconfig.json                 # TypeScript configuration
└── README.md                     # Documentation

Добавление новых функций

Чтобы добавить новые возможности Ansible на сервер MCP:

Измените src/ansible-mcp-server/index.ts
Добавьте новый инструмент в метод setupToolHandlers
Реализуйте функцию обработчика для вашего инструмента
Пересобрать с помощью npm run build

Лицензия

Лицензия MIT — подробности см. в разделе ЛИЦЕНЗИЯ

Ansible MCP Server

Integrations