OssHub

OssHub MCP Server provides unified access to multiple cloud object storage services through a single, flexible interface. You can connect to several providers, list and retrieve objects, search across buckets, and expose these capabilities to MCP clients such as Claude or Cursor. This lets you build AI-powered workflows that reason over your unstructured data in OBS, OSS, S3-compatible storage, and more.

How to use

Install OssHub and run it locally so MCP clients can connect to it. OssHub exposes built-in tools to list buckets, list objects, fetch object content, view metadata, and perform advanced searches. You can run OssHub in stdio mode for desktop/MCP clients or in HTTP mode for web-based clients.

Set up a local OssHub instance and connect it to your cloud storage providers by creating a configuration that defines each source with a unique identifier. You can then start OssHub and point your MCP client to the server endpoint or to the local stdio bridge, depending on your environment.

How to install

Prerequisites you need before installation: a supported runtime (Node.js), a package manager (npm or pnpm), and Git.

Clone the OssHub repository and install dependencies, then build the project before you run it.

# Clone the repository
git clone https://github.com/your-org/osshub.git
cd osshub

# Install dependencies
npm install
# or
pnpm install

# Build the project
npm run build
# or
pnpm build

Configuration and starting the server

You can configure OssHub using a TOML file or environment variables. The examples show multiple sources such as Huawei OBS, Alibaba OSS, and AWS S3 compatible storage. You can enable optional tools like list_objects or get_object with specific limits.

# Example TOML configuration (osshub.toml) with multiple sources
[[sources]]
id = "huawei_obs"
type = "obs"
endpoint = "https://obs.cn-east-2.myhuaweicloud.com"
access_key = "your-access-key"
secret_key = "your-secret-key"
region = "cn-east-2"

[[sources]]
id = "aliyun_oss"
type = "oss"
endpoint = "https://oss-cn-hangzhou.aliyuncs.com"
access_key = "your-access-key"
secret_key = "your-secret-key"
region = "cn-hangzhou"

[[sources]]
id = "minio"
type = "s3"
endpoint = "http://localhost:9000"
access_key = "minioadmin"
secret_key = "minioadmin"
path_style = true

# Optional tool configurations
[[tools]]
name = "list_objects"
source = "huawei_obs"
max_keys = 500

[[tools]]
name = "get_object"
source = "huawei_obs"
max_size = 5242880  # 5MB

# Run in STDIO mode for MCP clients (e.g., Claude Desktop)
npm start

# Run in HTTP mode for web-based MCP clients
npm start -- --transport=http --port=8080

Connecting with an MCP client

Two common ways to connect OssHub to an MCP client are via stdio (local process bridge) or via HTTP (network access). Use the stdio approach when your client integrates as a local module or uses a GUI client that expects a local bridge. Use HTTP when your client communicates over a web protocol.

• Start OssHub in the chosen mode
• Configure the MCP client with the OssHub endpoint
• Securely provide cloud provider credentials

Security and best practices

Keep your access keys and secret keys secure. Use per-source credentials and restrict permissions to only what is needed for the requested operations. If you expose OssHub over HTTP, enable proper authentication and TLS where possible. Rotate credentials regularly and avoid embedding secrets directly in code or configuration files that are checked into source control.

Built-in tools and capabilities

OssHub provides a set of built-in tools to interact with storage sources.

• list_buckets
• list_objects
• get_object
• get_object_metadata
• search_objects

Provider support

OssHub supports multiple object storage providers, enabling you to centralize access to diverse data stores.

Available tools

list_buckets

List all buckets in a source.

list_objects

List objects in a bucket with optional filtering and pagination.

get_object

Retrieve object content (text as plain text, binary as base64).

get_object_metadata

Get object metadata without downloading.

search_objects

Search objects with advanced filters (extension, size, date, pattern).