Orbixio Studio

MCP-native video script generation platform. Generate structured YouTube scripts through Claude Desktop (or any MCP client), review them, and approve before any downstream work begins.

Built as a TypeScript monorepo. No microservices, no workflow engines — just functions.

What it does today (v0)

• 6 MCP tools exposed over stdio: list_channels, get_channel, generate_script, review_script, approve_script, reject_script
• Structured script output validated by zod: hooks, 5 tool entries with honest caveats, CTAs, YouTube metadata
• Human-in-the-loop: scripts must be explicitly approved before any video work begins
• Multi-tenant ready: every row is scoped to a userId (single-user via env var for now)

Prerequisites

• Node.js 20+
• pnpm 9+
• PostgreSQL (local instance or Neon)
• Anthropic API key

Quick Start (< 10 minutes)

1. Clone and install

git clone https://github.com/AhmedAliQadit/orbixio-studio.git
cd orbixio-studio
pnpm install

2. Configure environment

cp .env.example .env

Edit .env with your values:

DATABASE_URL="postgresql://user:password@localhost:5432/orbixio_studio"
ANTHROPIC_API_KEY="sk-ant-..."
ORBIXIO_USER_ID="cldev000000000000000000"

3. Set up the database

# Create the database first (if local Postgres)
createdb orbixio_studio

# Run migrations
pnpm db:migrate

# Seed demo data
pnpm db:seed

4. Build all packages

pnpm build

5. Connect Claude Desktop

Add this to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "orbixio-studio": {
      "command": "node",
      "args": ["C:/ABSOLUTE/PATH/TO/orbixio-studio/packages/mcp-server/dist/index.js"],
      "env": {
        "DATABASE_URL": "postgresql://user:password@localhost:5432/orbixio_studio",
        "ANTHROPIC_API_KEY": "sk-ant-...",
        "ORBIXIO_USER_ID": "cldev000000000000000000"
      }
    }
  }
}

Replace C:/ABSOLUTE/PATH/TO with the actual path to your clone.

6. Test it

Restart Claude Desktop. You should see "orbixio-studio" in the MCP servers list. Try:

"List my channels, then generate a script about writing sales emails for the first channel."

Claude will call list_channels, then generate_script, and return a structured draft script for your review.

Project Structure

packages/
  db/            Prisma schema, client, seed
  core/          Pipeline logic (LLM provider, script generator, schemas)
  mcp-server/    MCP server wrapping core over stdio
apps/
  web/           Stubbed Next.js app (not implemented yet)

Scripts

Command	Description
pnpm build	Build all packages
pnpm test	Run all unit tests
pnpm test:smoke	Run end-to-end smoke test
pnpm db:migrate	Run Prisma migrations
pnpm db:seed	Seed demo data
pnpm lint	Lint with Biome

Stack

TypeScript, Prisma, PostgreSQL, @modelcontextprotocol/sdk, @anthropic-ai/sdk, zod, pino, vitest, Biome, pnpm workspaces.