Skip to main content

OCI Object Storage MCP Server

Overview

This server provides tools to interact with the OCI Object Storage resources. It includes tools to help with managing object storage configurations.

Running the server

STDIO transport mode

uvx oracle.oci-object-storage-mcp-server

HTTP streaming transport mode

ORACLE_MCP_HOST=<bind_host> \
ORACLE_MCP_PORT=<port> \
ORACLE_MCP_BASE_URL=<public_base_url> \
OCI_REGION=<region> \
IDCS_DOMAIN=<idcs_domain> \
IDCS_CLIENT_ID=<client_id> \
IDCS_CLIENT_SECRET=<client_secret> \
IDCS_AUDIENCE=<audience> \
uvx oracle.oci-object-storage-mcp-server

Register ${ORACLE_MCP_BASE_URL}/auth/callback in the OCI IAM confidential application. If IDCS_REQUIRED_SCOPES is unset, the default is openid profile email oci_mcp.object_storage.invoke.

Tools

Tool Name Description
get_namespace Get the object storage namespace for the tenancy
list_buckets List object storage buckets in a given compartment
get_bucket_details Get details for a specific object storage bucket
list_objects List objects in a given object storage bucket
list_object_versions List object versions in a given object storage bucket
get_object Get a specific object from an object storage bucket
upload_object Upload an object to an object storage bucket

⚠️ NOTE: stdio uses the configured OCI CLI profile. HTTP uses the authenticated OCI IAM user and does not use the local OCI CLI profile for request authentication.

Third-Party APIs

Developers choosing to distribute a binary implementation of this project are responsible for obtaining and providing all required licenses and copyright notices for the third-party code used in order to ensure compliance with their respective open source licenses.

Disclaimer

Users are responsible for their local environment and credential safety. Different language model selections may yield different results and performance.

Upload root

upload_object only reads files under OCI_MCP_UPLOAD_ROOT (default: <tmpdir>/oci-mcp-uploads). Set this to the directory you intend to upload from. Paths outside the root, and paths under ~/.oci, ~/.ssh, /etc, /run/secrets, or /var/run/secrets, are rejected.

License

Copyright (c) 2025 Oracle and/or its affiliates.

Released under the Universal Permissive License v1.0 as shown at
https://oss.oracle.com/licenses/upl/.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

oracle_oci_object_storage_mcp_server-2.0.2.tar.gz (12.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

File details

Details for the file oracle_oci_object_storage_mcp_server-2.0.2.tar.gz.

File metadata

  • Download URL: oracle_oci_object_storage_mcp_server-2.0.2.tar.gz
  • Upload date:
  • Size: 12.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Oracle Linux Server","version":"9.8","id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for oracle_oci_object_storage_mcp_server-2.0.2.tar.gz
Algorithm Hash digest
SHA256 4794b438d1e0048686a66922fdce64e022b419cb6b4051fac8a1af6b221bfda2
MD5 7f688ca5db67bb21a8b7e082f888dfa2
BLAKE2b-256 5aedcffefc83cf574eeecca930342c9a76d2f49547fdb88a7bdc37e353e81361

See more details on using hashes here.

File details

Details for the file oracle_oci_object_storage_mcp_server-2.0.2-py3-none-any.whl.

File metadata

  • Download URL: oracle_oci_object_storage_mcp_server-2.0.2-py3-none-any.whl
  • Upload date:
  • Size: 10.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Oracle Linux Server","version":"9.8","id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for oracle_oci_object_storage_mcp_server-2.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 0be39c6a1c4fe8e80fcd5a57bcf67b64eac8f3436f3ad48e8365256537d85f40
MD5 6a5dbd7675271542d2d70d6317c14bb7
BLAKE2b-256 5892c3479db7f87564161b65f851413822a8fec54e309c6ea547730c349068e0

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

2.0.2 This release

2 files

2.0.1

2 files

2.0.0

2 files

1.1.2

2 files

1.1.0

2 files

1.0.1

2 files

1.0.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page