oracle-cloud-mcp

[!License: MIT](https://opensource.org/licenses/MIT) [!MCP](https://modelcontextprotocol.io) [!Node.js](https://nodejs.org)

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