Oracle Cloud Infrastructure

You can deploy this MCP server to integrate Oracle Cloud Infrastructure with Claude Code, giving you programmatic access to OCI services such as Compute, Object and Block Storage, Networking, Autonomous Database, and IAM actions through simple MCP endpoints. This enables you to automate cloud operations, orchestrate workflows, and interact with OCI resources directly from Claude Code.

How to use

You will connect your MCP client to the Oracle MCP Server and use its tools to manage OCI resources. Start by ensuring your MCP client is configured to communicate with the local or remote MCP server, then call the relevant tool by name to perform actions such as listing compute instances, managing storage, or handling autonomous databases. The server exposes tools grouped by OCI services, so you can perform granular operations like listing VCNs, creating a new VCN, or starting a stopped Autonomous Database.

Common usage patterns include listing resources in a compartment, obtaining detailed information about a resource, and performing state-changing actions (for example, starting or stopping a compute instance). You will receive structured results that reflect the current state of your OCI resources, allowing you to build automated workflows or chat-assisted cloud management.

How to install

Prerequisites: You need Node.js and npm installed on your system.

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

Additional setup and usage notes

For OCI access, you must configure the OCI CLI with a valid config file or use session token authentication. The recommended approach is to store your credentials in the default OCI config file and optionally enable session-based authentication for interactive use.

Add the MCP server to Claude Code by providing the following configuration. This sets the server to run locally with Node.js and points to the server script. The environment variables provide OCI access details.

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

Authentication methods

The server supports two authentication methods: Session Token and API Key. Session Token is recommended for interactive workflows and can be refreshed with OCI CLI. API Key is suitable for automation and uses an RSA key pair along with a fingerprint in the OCI config.

Choose the method that best fits your workflow and securely store credentials. The MCP server will utilize the configured OCI credentials to perform operations against OCI resources.

Usage examples

Example: List all OCI compute instances in a compartment.

Example: Start a stopped compute instance.

Available tools

oci_compute_list_instances

List all compute instances in a compartment

oci_compute_get_instance

Get detailed information about a specific compute instance

oci_compute_list_shapes

List available shapes for compute instances, including Always Free shapes

oci_compute_instance_action

Perform actions on compute instances such as START, STOP, RESET, and more

oci_os_get_namespace

Retrieve the Object Storage namespace

oci_os_list_buckets

List all buckets within a compartment

oci_os_create_bucket

Create a newObject Storage bucket

oci_os_list_objects

List objects within a bucket

oci_os_delete_bucket

Delete an empty Object Storage bucket

oci_bv_list_volumes

List all block volumes

oci_bv_list_boot_volumes

List boot volumes

oci_vcn_list

List Virtual Cloud Networks (VCNs)

oci_subnet_list

List subnets within a VCN

oci_vcn_create

Create a new Virtual Cloud Network

oci_adb_list

List Autonomous Databases

oci_adb_get

Get details of an Autonomous Database

oci_adb_start

Start a stopped Autonomous Database

oci_adb_stop

Stop a running Autonomous Database

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 in the tenancy

oci_iam_list_availability_domains

List availability domains in the current region