Skip to main content
Glama

HybridHub

Universal Hybrid Data MCP Server - Connect to both structured (databases) and unstructured (object storage) data sources.

Features

  • Structured Data Sources (Databases)

    • PostgreSQL

    • MySQL

    • MariaDB

    • SQL Server

    • SQLite

  • Unstructured Data Sources (Object Storage)

    • Huawei Cloud OBS

    • Alibaba Cloud OSS

    • AWS S3 / S3-Compatible (MinIO, etc.)

    • Tencent Cloud COS

Quick Start

1. Install Dependencies

npm install
# or
yarn install
# or
pnpm install

2. Configure Data Sources

Copy the sample configuration file:

cp env.sample .env

Edit .env with your data source credentials.

For multi-source configuration, copy and edit the TOML example:

cp hybridhub.toml.example hybridhub.toml

3. Run the Server

# Development mode
npm run dev

# Production mode
npm run build
npm start

Configuration

Environment Variables

Variable

Description

Example

HYBRIDHUB_TRANSPORT

Transport mode

stdio or http

HYBRIDHUB_PORT

HTTP port

8080

HYBRIDHUB_API_KEY

API key for authentication

your-api-key

Database Configuration

Variable

Description

Example

DSN

Database connection string

postgres://user:pass@localhost:5432/db

DB_TYPE

Database type

postgres, mysql, sqlite, etc.

DB_HOST

Database host

localhost

DB_PORT

Database port

5432

DB_NAME

Database name

mydb

DB_USER

Database username

user

DB_PASSWORD

Database password

password

DB_READONLY

Enable read-only mode

true or false

DB_MAX_ROWS

Maximum rows per query

1000

Storage Configuration

Variable

Description

Example

STORAGE_TYPE

Storage provider type

s3, oss, obs, etc.

STORAGE_ENDPOINT

Storage endpoint URL

https://s3.amazonaws.com

STORAGE_ACCESS_KEY

Access key ID

AKIAIOSFODNN7EXAMPLE

STORAGE_SECRET_KEY

Secret access key

wJalrXUtnFEMI...

STORAGE_REGION

Storage region

us-east-1

STORAGE_PATH_STYLE

Use path-style URLs (for MinIO)

true or false

TOML Configuration

For multi-source configuration, use hybridhub.toml:

# Database source
[[databases]]
id = "prod_pg"
dsn = "postgres://user:password@localhost:5432/production"
readonly = false
max_rows = 1000

# Storage source
[[storages]]
id = "aws_s3"
type = "s3"
endpoint = "https://s3.amazonaws.com"
access_key = "AKIAIOSFODNN7EXAMPLE"
secret_key = "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
region = "us-east-1"

See hybridhub.toml.example for complete configuration options.

MCP Tools

Database Tools

  • execute_sql - Execute SQL queries on database sources

Storage Tools

  • list_buckets - List all storage buckets

  • list_objects - List objects in a bucket

  • get_object - Get object content

  • get_object_metadata - Get object metadata

  • search_objects - Search objects with filters

Development

# Run in development mode
npm run dev

# Run with HTTP transport
npm run dev:http

# Build for production
npm run build

# Run tests
npm test

License

MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/zq940222/hybrid-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server