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

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