mcp-oci

Сервер Model Context Protocol для Oracle Cloud Infrastructure (OCI). Он даёт MCP-совместимому клиенту (Claude Desktop, Claude Code, Cursor, Copilot, …) возможность находить живые ресурсы OCI, строить карту их связей и генерировать воспроизводимый Terraform — причём поведение полностью управляется флагами.

Представьте себе Playwright-MCP для вашего облака: вместо того чтобы вручную восстанавливать знания об инфраструктуре, модель может спросить «покажи все VCN в компартменте prod» и «сгенерируй Terraform для этого компартмента» — и получить структурированные ответы без секретов.

Возможности

• Живое обнаружение — компартменты, регионы и любой ресурс через OCI Resource Search.

• Генерация Terraform — точный HCL для известных типов ресурсов (VCN, subnet, instance, bucket, compartment) и аннотированные скелеты для остальных; модули всего компартмента с переменными провайдера.

• Граф зависимостей — узлы и рёбра плюс рекомендуемый порядок развёртывания (сначала зависимости).

• Секреты никогда не попадают в модель — все данные редактируются перед возвратом.

• Флаги безопасности — режимы доступа, списки разрешённых компартментов и регионов, шлюз развёртывания, dry-run и ведение JSON-журнала аудита (см. ниже).

• Стандартная аутентификация — файл конфигурации OCI (~/.oci/config) или instance principals. Сервер не хранит учётные данные.

Related MCP server: oci-mcp-server

Модель безопасности

Инструменты

Обнаружение (чтение): list_compartments, list_regions, search_resources, list_components, get_resource

Terraform (чтение): generate_terraform, generate_compartment_terraform, build_dependency_graphафф

Использование с MCP-клиентом

Работает с Claude Code, Claude Desktop, Cursor, OpenAI Codex CLI, Windsurf, VS Code (Copilot) и любым другим MCP-клиентом — см. docs/CLIENTS.md для настройки под каждый клиент.

Установка

npm install
npm run build

Настройка

Укажите через стандартный профиль конфигурации OCI. Для безопасности используйте пользователя/политику IAM с правами только для чтения (inspect/read) на компартменты, которые агент должен видеть.

Запуск с Claude Desktop / Claude Code / Cursor

{
  "mcpServers": {
    "oci": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-oci/dist/index.js"],
      "env": {
        "OCI_PROFILE": "DEFAULT",
        "OCI_MODE": "read-only",
        "OCI_COMPARTMENT_ALLOWLIST": "ocid1.compartment.oc1..xxxx",
        "OCI_REGION_ALLOWLIST": "us-ashburn-1"
      }
    }
  }
}

Примеры запросов

• „Перечисли все компартменты, затем покажи все ресурсы в prod компартменте.“—* (or better: *"Перечисли все компартменты, затем покажи все ресурсы в компартментеprod`."

• "Сгенерируй Terraform для VCN ocid1.vcn.oc1..…."

• "Постарайся построить граф зависимостей для … и скажи порядок развёртывания."

Разработка

npm run dev        # watch mode
npm test           # security policy + terraform generation + graph + redaction
npm run typecheck

Дорожная карта

• Выполнение terraform plan/apply за флагами read-write/admin + OCI_ALLOW_APPLY.

• Дополнительные модули мапперов(load balancerОв, баз данных, DRGs, IAM-полиций).

• Сравнение дрейфа среды.

Публикация

Сервер включает server.json для официального реестра MCP и mcpName для проверки владельца пакета npm. См. PUBLISHING.md для публикации на npm и лизинга в MCP-реестре, Smithery, Glama, Cursor и PulseMCP.

Лицензия

MIT