mcp-oci

Oracle Cloud Infrastructure (OCI) 向けの Model Context Protocol サーバーです。MCP 対応クライアント (Claude Desktop、Claude Code、Cursor、Copilot、…) に、実際の OCI リソースの発見、リソース間の関係性のマッピング、再現可能な Terraform の生成を提供します。動作はすべてフラグによって完全に制御されます。

クラウド向けの Playwright-MCP だと考えてください。インフラの知識を手作業で再構築する代わりに、モデルに "prod コンパートメント内のすべての VCN を表示" や "このコンパートメント用の Terraform を生成" と尋ねるだけで、構造化されたシークレットを含まない回答が得られます。

機能

• ライブ検出 — コンパートメント、リージョン、および OCI Resource Search 経由の任意のリソースを検出します。

• Terraform 生成 — 既知の型 (VCN、サブネット、インスタンス、バケット、データベース) には忠実な HCL を、それ以外には注釈付きスケルトンを生成。コンパートメント全体のモジュール（プロバイダー変数を含む）も生成します。

• 依存関係グラフ — ノードとエッジに加え、推奨されるプロビジョニング順序 (依存関係を先に) を提供します。

• シークレットがモデルに到達することはありません — すべてのペイロードは返却前にマスクされます。

• セキュリティフラグ — アクセスモード、コンパートメント/リージョンの許可リスト、プロビジョニングゲート、ドライラン、JSON 監査ログ (下記参照)。

• 標準認証 — OCI 設定ファイル (~/.oci/config) またはインスタンスのプリンシパル。サーバーが認証情報を保存することはありません。

Related MCP server: oci-mcp-server

セキュリティモデル

ツール

ディスカバリ (読み取り): list_compartments, list_regions, search_resources, list_compartment_resources, 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 設定プロファイルを指定します。安全性のため、エージェントに表示させたいコンパートメントに対して読み取り専用 (inspect / read) 権限を持つ IAM ユーザー/ポリシーを使用してください。

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 コンパートメント内のすべてのリソースを表示してください。"

• "VCN ocid1.vcn.oc1..… の Terraform を生成してください。"

• "コンパートメント … の依存関係グラフを構築し、プロビジョニングの順序を教えてください。"

開発

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

ロードマップ

• read-write / admin + OCI_ALLOW_APPLY を前提とした terraform plan / apply の実行。

• より多くのリソース型マッパー (ロードバランサー、データベース、DRG、IAM ポリシー)。

• 環境間のドリフト比較。

公開

このサーバーには、公式の MCP レジストリ用の server.json と、npm の所有権検証用の mcpName が含まれています。npm への公開、MCP レジストリ、Smithery、Glama、Cursor、PulseMCP への掲載については、PUBLISHING.md を参照してください。

ライセンス

MIT