English Français العربية

io.github.ExpertVagabond/oracle-cloud

Official registry Cloud and DevOps

Oracle Cloud Infrastructure MCP server

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package oracle-cloud-mcp
Claude Code 
claude mcp add oracle-cloud -- npx -y oracle-cloud-mcp@1.0.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "oracle-cloud": {
            "command": "npx",
            "args": [
                "-y",
                "oracle-cloud-mcp@1.0.1"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. oracle-cloud-mcp
  2. Tools (23 total)
  3. Install
  4. Configuration
  5. Authentication
  6. Oracle Cloud Free Tier
  7. Dependencies
  8. License

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)
ToolDescription
oci_compute_list_instancesList all VM instances in a compartment
oci_compute_get_instanceGet detailed info for a specific instance
oci_compute_list_shapesList available shapes (including Always Free)
oci_compute_instance_actionSTART, STOP, RESET, SOFTSTOP, or SOFTRESET an instance
Object Storage (5 tools)
ToolDescription
oci_os_get_namespaceGet the Object Storage namespace
oci_os_list_bucketsList all buckets in a compartment
oci_os_create_bucketCreate a new bucket (Standard or Archive)
oci_os_list_objectsList objects with optional prefix filter
oci_os_delete_bucketDelete an empty bucket
Block Storage (2 tools)
ToolDescription
oci_bv_list_volumesList block volumes
oci_bv_list_boot_volumesList boot volumes in an availability domain
Networking (3 tools)
ToolDescription
oci_vcn_listList Virtual Cloud Networks
oci_subnet_listList subnets in a VCN
oci_vcn_createCreate a new VCN with CIDR blocks
Autonomous Database (4 tools)
ToolDescription
oci_adb_listList Autonomous Databases (ATP/ADW)
oci_adb_getGet database details and connection strings
oci_adb_startStart a stopped database
oci_adb_stopStop a running database
IAM (5 tools)
ToolDescription
oci_iam_list_usersList IAM users
oci_iam_list_groupsList IAM groups
oci_iam_list_policiesList IAM policies and statements
oci_iam_list_compartmentsList compartments in the tenancy
oci_iam_list_availability_domainsList 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
VariableDescriptionRequired
OCI_CONFIG_FILEPath to OCI config fileNo (defaults to ~/.oci/config)
OCI_PROFILEConfig profile nameNo (defaults to DEFAULT)
OCI_TENANCY_OCIDTenancy OCIDNo (read from config)
OCI_REGIONOCI regionNo (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

ResourceFree Allocation
Compute (Ampere A1)4 OCPUs, 24 GB RAM
Compute (AMD E2.1.Micro)2 instances
Object Storage20 GB Standard + 20 GB Archive
Block Storage200 GB total
Autonomous Database2 Always Free databases
Outbound Data10 TB/month

Dependencies

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

License

MIT

Frequently asked questions

What is io.github.ExpertVagabond/oracle-cloud?

Oracle Cloud Infrastructure MCP server

How do I install io.github.ExpertVagabond/oracle-cloud?

It runs on your machine. In Claude Code: claude mcp add oracle-cloud -- npx -y oracle-cloud-mcp@1.0.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.ExpertVagabond/oracle-cloud need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.ExpertVagabond/oracle-cloud open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.ExpertVagabond/oracle-cloud?

It is published by ExpertVagabond. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.