GitHub - serenorg/seren: Seren CLI & MCP

2 min read Original article ↗

Seren

Official Rust SDK, CLI, and MCP server for SerenAI - the team behind SerenDB, a serverless Postgres platform with built-in agent commerce and micropayments.

Packages

Package Description Status
seren Rust SDK for the SerenAI API (SerenDB) crates.io
seren-cli Command-line interface Not published on crates.io yet
seren-mcp MCP server for AI assistants Not published on crates.io yet

Quick Start

MCP Server (AI Integration)

Connect Claude or other AI assistants to SerenAI:

# Claude Code (recommended - no local install needed)
claude mcp add --scope user --transport http seren https://mcp.serendb.com/mcp

Or configure manually for Claude Desktop:

{
  "mcpServers": {
    "seren": {
      "url": "https://mcp.serendb.com/mcp",
      "transport": "streamable-http"
    }
  }
}

See mcp/README.md for local server setup and all configuration options.

CLI

# Install from source (see Installation below)
cargo install --path cli

# Login and start managing databases
seren auth login
seren projects list
seren projects create --name my-project --region aws-us-east-1

Rust SDK

[dependencies]
seren = "0.3"
use seren::{Client, ClientConfig};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let config = ClientConfig::new("seren_your_api_key");
    let client = Client::from_config(&config)?;

    let projects = client.list_projects(None, None, None).await?;
    println!("Found {} projects", projects.into_inner().data.len());

    Ok(())
}

Installation

From Source

git clone https://github.com/serenorg/seren.git
cd seren

# Build all packages
cargo build --release

# Install CLI
cargo install --path cli

# Install MCP server
cargo install --path mcp

Pre-built Binaries

Download pre-built binaries from GitHub Releases (tagged versions): https://github.com/serenorg/seren/releases

Each release asset includes:

  • seren (CLI)
  • seren-mcp (MCP server)

Development

Prerequisites

  • Rust 1.85+ (edition 2024)
  • PostgreSQL (for MCP OAuth mode and integration tests)

Building

# Build all packages
cargo build --workspace

# Run tests
cargo test --workspace

# Lint
cargo clippy --all-targets -- -D warnings

# Format
cargo fmt --all

Project Structure

seren/
├── api/            # Rust SDK - OpenAPI-generated type-safe client
├── cli/            # CLI tool - clap-based database management
├── mcp/            # MCP server - stdio, HTTP, and OAuth modes
│   ├── oauth/      #   OAuth 2.1 + PKCE implementation
│   ├── wallet/     #   x402 crypto payment support
│   └── migrations/ #   Embedded SQL migrations
├── openapi/        # OpenAPI spec (source for SDK codegen)
├── docker/         # Dockerfiles
└── Cargo.toml      # Workspace configuration

Documentation

License

MIT License - see LICENSE for details.

Support