Skip to main content

OCI Object Storage Service MCP server

Project description

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/.

Project details


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.0.tar.gz (69.2 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.0.tar.gz.

File metadata

  • Download URL: oracle_oci_object_storage_mcp_server-2.0.0.tar.gz
  • Upload date:
  • Size: 69.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.8 {"installer":{"name":"uv","version":"0.11.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"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.0.tar.gz
Algorithm Hash digest
SHA256 f78e76752ea5c0529b7485fca8d08a24db5eaed5f55ed0513957eecf3fed29eb
MD5 71e7646ab657215bb94d01802321d385
BLAKE2b-256 eead49245c87ee44c8601c2e22fdebab83e7ff0f0294cba5f834bf1e18bc2028

See more details on using hashes here.

File details

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

File metadata

  • Download URL: oracle_oci_object_storage_mcp_server-2.0.0-py3-none-any.whl
  • Upload date:
  • Size: 10.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.8 {"installer":{"name":"uv","version":"0.11.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 66124896ae76c4b17a8dd8dd31b5b2f138488db0c7d36ae43393d86bdd169ec3
MD5 5b1373692306c53021272e3fdabf016d
BLAKE2b-256 8f62396709fbf681442b4e753773d8f8e0c46d503829dd87665465a627993a1d

See more details on using hashes here.

Supported by

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