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.1.tar.gz (71.3 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.1.tar.gz.

File metadata

  • Download URL: oracle_oci_object_storage_mcp_server-2.0.1.tar.gz
  • Upload date:
  • Size: 71.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","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.1.tar.gz
Algorithm Hash digest
SHA256 f33c043dc35ece8d6d475b8cd847b8e4c09bf6061792944a293738d5287f3190
MD5 b2b6a01b66a907cd79547b741987c6de
BLAKE2b-256 0b865a46968098c9c84bd14d41760a90ad95b1eaa3a775317dc6b09bb4ad009f

See more details on using hashes here.

File details

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

File metadata

  • Download URL: oracle_oci_object_storage_mcp_server-2.0.1-py3-none-any.whl
  • Upload date:
  • Size: 10.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 900405eb8172ccf44f158b482c119821ef544b0ba2bb8cf015d3217b6dc732bd
MD5 8ebea83cf3533bb6f3d2742821bb5870
BLAKE2b-256 ec42637a680441db29eeeefc65abbf5f7629b1d6050f186a122fb6d1be2dee57

See more details on using hashes here.

Release history Release notifications | RSS feed

2.0.2

2 files

This release

2.0.1 This release

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