Oracle Cloud Infrastructure MCP Server

MCP server for Oracle Cloud Infrastructure (OCI) integration with Claude Code. Provides comprehensive access to OCI services including Compute, Storage, Networking, Database, and IAM.

Features

Compute - List, manage, and control VM instances
Object Storage - Manage buckets and objects
Block Storage - List block and boot volumes
Networking - VCNs, subnets, and network management
Autonomous Database - ATP/ADW database operations
IAM - Users, groups, policies, and compartments

Available Tools (21 total)

Compute (4 tools)

Tool	Description
`oci_compute_list_instances`	List all compute instances in a compartment
`oci_compute_get_instance`	Get detailed info about a specific instance
`oci_compute_list_shapes`	List available shapes (incl. Always Free)
`oci_compute_instance_action`	Perform actions (START, STOP, RESET, etc.)

Object Storage (5 tools)

Tool	Description
`oci_os_get_namespace`	Get the Object Storage namespace
`oci_os_list_buckets`	List all buckets in compartment
`oci_os_create_bucket`	Create a new bucket
`oci_os_list_objects`	List objects in a bucket
`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

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

Autonomous Database (4 tools)

Tool	Description
`oci_adb_list`	List Autonomous Databases
`oci_adb_get`	Get database details
`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
`oci_iam_list_compartments`	List compartments
`oci_iam_list_availability_domains`	List availability domains

Setup

1. Install Dependencies

cd ~/mcp-servers/oracle-mcp
npm install

2. Configure OCI

Ensure you have OCI CLI configured with a valid config file:

# ~/.oci/config should contain:
[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

Or use session token authentication:

oci session authenticate

3. Add to Claude Code

Add to ~/.claude.json:

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

Free Tier Resources

Oracle Cloud Free Tier includes:

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

Architecture

Claude Code (Opus 4.5)
         │
         └──▶ Oracle MCP Server
                    │
                    └──▶ OCI SDK
                              │
                              ├── Compute Service
                              ├── Object Storage
                              ├── Block Storage
                              ├── Virtual Network
                              ├── Database Service
                              └── Identity Service

Authentication

The server supports two authentication methods:

Session Token (recommended for interactive use)
- Uses security_token_file from config
- Refreshable with oci session refresh
API Key (for automation)
- Uses RSA key pair
- Requires fingerprint in OCI config

Usage Examples

User: List my OCI compute instances

Claude: [Uses oci_compute_list_instances tool]
Result:
- web-server-1 (VM.Standard.A1.Flex) - RUNNING
- db-server (VM.Standard.E2.1.Micro) - STOPPED

User: Start the db-server instance

Claude: [Uses oci_compute_instance_action with action=START]
Result: Instance db-server is now starting...

Files

index.js - MCP server implementation
package.json - Dependencies
README.md - This file

Dependencies

@modelcontextprotocol/sdk - MCP SDK
oci-sdk - Official Oracle Cloud SDK

Author

Matthew Karsten

License

MIT

oracle-cloud

Quick Install