oracle-cloud-mcp

\ \ \

MCP server for Oracle Cloud Infrastructure (OCI). Provides access to Compute, Object Storage, Block Storage, Networking, Autonomous Database, and IAM via the official OCI SDK.

Tools (23 total)

Compute (4 tools)

| Tool | Description | |------|-------------| | oci_compute_list_instances | List all VM instances in a compartment | | oci_compute_get_instance | Get detailed info for a specific instance | | oci_compute_list_shapes | List available shapes (including Always Free) | | oci_compute_instance_action | START, STOP, RESET, SOFTSTOP, or SOFTRESET an instance |

Object Storage (5 tools)

| Tool | Description | |------|-------------| | oci_os_get_namespace | Get the Object Storage namespace | | oci_os_list_buckets | List all buckets in a compartment | | oci_os_create_bucket | Create a new bucket (Standard or Archive) | | oci_os_list_objects | List objects with optional prefix filter | | oci_os_delete_bucket | Delete an empty bucket |

Block Storage (2 tools)

| Tool | Description | |------|-------------| | oci_bv_list_volumes | List block volumes | | oci_bv_list_boot_volumes | List boot volumes in an availability domain |

Networking (3 tools)

| Tool | Description | |------|-------------| | oci_vcn_list | List Virtual Cloud Networks | | oci_subnet_list | List subnets in a VCN | | oci_vcn_create | Create a new VCN with CIDR blocks |

Autonomous Database (4 tools)

| Tool | Description | |------|-------------| | oci_adb_list | List Autonomous Databases (ATP/ADW) | | oci_adb_get | Get database details and connection strings | | oci_adb_start | Start a stopped database | | oci_adb_stop | Stop a running database |

IAM (5 tools)

| Tool | Description | |------|-------------| | oci_iam_list_users | List IAM users | | oci_iam_list_groups | List IAM groups | | oci_iam_list_policies | List IAM policies and statements | | oci_iam_list_compartments | List compartments in the tenancy | | oci_iam_list_availability_domains | List availability domains |

Install

npm install

Configuration

Configure OCI credentials in ~/.oci/config:

[DEFAULT]
user=ocid1.user.oc1..xxx
fingerprint=xx:xx:xx:xx:xx
tenancy=ocid1.tenancy.oc1..xxx
region=us-chicago-1
key_file=~/.oci/api_keys/oci_api_key.pem

Add to your Claude Code MCP config:

{
  "mcpServers": {
    "oracle": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/oracle-mcp/index.js"],
      "env": {
        "OCI_CONFIG_FILE": "~/.oci/config",
        "OCI_PROFILE": "DEFAULT",
        "OCI_REGION": "us-chicago-1"
      }
    }
  }
}

Environment Variables

| Variable | Description | Required | |----------|-------------|----------| | OCI_CONFIG_FILE | Path to OCI config file | No (defaults to ~/.oci/config) | | OCI_PROFILE | Config profile name | No (defaults to DEFAULT) | | OCI_TENANCY_OCID | Tenancy OCID | No (read from config) | | OCI_REGION | OCI region | No (defaults to us-chicago-1) |

Authentication

Supports two methods:

1. Session Token -- uses security_token_file from config (recommended for interactive use)
2. API Key -- uses RSA key pair with fingerprint (for automation)

Oracle Cloud Free Tier

| Resource | Free Allocation | |----------|-----------------| | Compute (Ampere A1) | 4 OCPUs, 24 GB RAM | | Compute (AMD E2.1.Micro) | 2 instances | | Object Storage | 20 GB Standard + 20 GB Archive | | Block Storage | 200 GB total | | Autonomous Database | 2 Always Free databases | | Outbound Data | 10 TB/month |

Dependencies

• @modelcontextprotocol/sdk -- MCP protocol SDK
• oci-sdk -- Official Oracle Cloud SDK for Node.js

License

MIT