oracle-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.
| 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 |
| 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 |
| Tool | Description |
|---|
oci_bv_list_volumes | List block volumes |
oci_bv_list_boot_volumes | List boot volumes in an availability domain |
| 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 |
| 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 |
| 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
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_file from 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
MIT