npm oracle-cloud-mcpstdioMITupdated 5mo ago
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.
What can you do with oracle cloud?
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.
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
Install
Add oracle cloud to your client. Pick the one you use.
claude mcp add oracle-cloud-mcp -- npx -y oracle-cloud-mcpcodex mcp add oracle-cloud-mcp -- npx -y oracle-cloud-mcpamp mcp add oracle-cloud-mcp -- npx -y oracle-cloud-mcp{
"mcpServers": {
"oracle-cloud-mcp": {
"command": "npx",
"args": [
"-y",
"oracle-cloud-mcp"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"oracle-cloud-mcp": {
"command": "npx",
"args": [
"-y",
"oracle-cloud-mcp"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"oracle-cloud-mcp","command":"npx","args":["-y","oracle-cloud-mcp"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"oracle-cloud-mcp": {
"command": "npx",
"args": [
"-y",
"oracle-cloud-mcp"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"oracle-cloud-mcp": {
"command": "npx",
"args": [
"-y",
"oracle-cloud-mcp"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"oracle-cloud-mcp": {
"command": "npx",
"args": [
"-y",
"oracle-cloud-mcp"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"oracle-cloud-mcp": {
"type": "local",
"command": "npx",
"args": [
"-y",
"oracle-cloud-mcp"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"oracle-cloud-mcp": {
"command": {
"path": "npx",
"args": [
"-y",
"oracle-cloud-mcp"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y oracle-cloud-mcpRun `goose configure`, choose **Add Extension ā Command-line Extension**, and paste this command.
Score
39 / 100
Incomplete
- Documentation25/25
- Maintenance13/25
- Trust13/20
- Capability0/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 168 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint ā no local install
Version history
| Versions | Published |
|---|---|
| 1.0.1Latest | Feb 14, 2026 |