OCI MCP Server

An MCP (Model Context Protocol) server that gives Claude and other LLM clients natural-language access to Oracle Cloud Infrastructure resources.

Ask questions like:

• "List all running compute instances in my prod compartment"
• "What OKE clusters do we have, and which Kubernetes versions are they on?"
• "Show me the subnets in our main VCN"
• "Which Object Storage buckets are in the analytics compartment?"

Covered Services

Service	Tools
Identity	get_tenancy, list_compartments, list_regions, list_availability_domains
Compute	list_instances, get_instance, list_shapes
Networking	list_vcns, list_subnets, list_security_lists, list_internet_gateways
Object Storage	get_object_storage_namespace, list_buckets, list_objects, get_bucket
OKE	list_oke_clusters, get_oke_cluster, list_node_pools, list_cluster_options

Prerequisites

• Python 3.10+
• OCI CLI configured (~/.oci/config) — setup guide
• An OCI user with at minimum read permissions on the resources you want to query

Installation

git clone https://github.com/sauryadas/oci-mcp-server
cd oci-mcp-server
pip install -e .

Verify it starts cleanly:

python server.py

Configuration

The server reads your OCI credentials from ~/.oci/config (the same file used by the OCI CLI). To use a non-default profile or config path, set environment variables before starting the server:

export OCI_CLI_PROFILE=MY_PROFILE          # default: DEFAULT
export OCI_CLI_CONFIG_FILE=~/.oci/config   # default: ~/.oci/config

Connect to Claude Desktop

Add the following to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "oci": {
      "command": "python",
      "args": ["/Users/<you>/projects/oci-mcp-server/server.py"]
    }
  }
}

Restart Claude Desktop and you'll see the OCI tools available in the tool picker.

Connect to Claude Code

claude mcp add oci -- python /Users/<you>/projects/oci-mcp-server/server.py

Example Prompts

What compartments do I have in my tenancy?

List all RUNNING instances in compartment ocid1.compartment.oc1..xxx

Show me the OKE clusters in my dev compartment and what Kubernetes versions they're running.

What subnets are in VCN ocid1.vcn.oc1..xxx ?

List the Object Storage buckets in my analytics compartment.

Project Structure

oci-mcp-server/
├── server.py          # MCP server entry point
├── pyproject.toml
└── tools/
    ├── base.py        # shared OCI client initialisation
    ├── identity.py    # tenancy, compartments, regions
    ├── compute.py     # instances, shapes
    ├── networking.py  # VCNs, subnets, security lists
    ├── storage.py     # Object Storage buckets & objects
    └── containers.py  # OKE clusters & node pools

Roadmap

• [ ] Database service (Autonomous DB, MySQL HeatWave)
• [ ] IAM policies and groups
• [ ] Resource tagging and search across compartments
• [ ] Instance action support (start/stop) with confirmation prompts
• [ ] Oracle Alloy operator-tier views

License

MIT