io.github.ExpertVagabond/oracle-cloud

Official

by ExpertVagabond · JavaScript

Oracle Cloud Infrastructure MCP server

Oracle Cloud Infrastructure CLI access and resource management.

Topics

aimcpmodel-context-protocoltoolsautonomous-databaseclaude-codecomputefree-tierobject-storageocioracle-cloud

README.md4 KBView on GitHub

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

bash

npm install

Configuration

Configure OCI credentials in ~/.oci/config:

ini

[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:

json

{
  "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:

Session Token -- uses security_token_file from config (recommended for interactive use)
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

Install

claude_desktop_config.json

{
  "mcpServers": {
    "oracle-cloud": {
      "command": "npx",
      "args": [
        "-y",
        "oracle-cloud-mcp@1.0.1"
      ]
    }
  }
}