About oracle-cloud
oracle-cloud is an MCP server for managing Oracle Cloud Infrastructure through the official OCI SDK. It provides tools across compute, storage, networking, Autonomous Database, and IAM.
Key features
- 01List and control compute instances
- 02Manage Object Storage buckets and objects
- 03List block and boot volumes
- 04View and create VCNs and subnets
- 05Inspect Autonomous Database and IAM
Use cases
- 01Review and control OCI compute instances
- 02Manage Object Storage buckets
- 03Inspect network, database, and IAM resources
MCP support
Exposes OCI resource queries and selected management actions as tools for MCP clients across compute, storage, networking, Autonomous Database, and IAM.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
23Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | number | No | Maximum number of instances to return |
| compartment_id | string | No | Compartment OCID (defaults to tenancy) |
Details
From the project READMEoracle-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
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
| 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_filefrom 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 SDKoci-sdk-- Official Oracle Cloud SDK for Node.js
License
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.