Voize

Overview

Voize

generate_tts_url

Tech Stack

• Language: TypeScript
• Runtime: Bun 1.0+
• Key dependencies:

  @modelcontextprotocol/sdk

  ,

  @aws-sdk/client-s3

  ,

  zod

Architecture

src/
├── index.ts
├── lib/
│   ├── provider.ts
│   └── storage.ts
├── tools/
│   └── generateTtsUrl.ts
├── types.ts
└── utils/
    ├── env.ts
    ├── log.ts
    ├── retry.ts
    └── validate.ts

Development

Setup

bun install
cp .env.example .env

Build

bun run build

Test

Lint

bun run lint

Typecheck

bun run typecheck

Key Files

src/index.ts

src/tools/generateTtsUrl.ts

src/lib/provider.ts

src/lib/storage.ts

docs/architecture.md

Agent Guidelines

• Never write to stdout in server code (stdio JSON-RPC safety).
• Return structured JSON in MCP text content for both success and failure.
• Keep public-domain enforcement at startup.
• Do not introduce direct Nexus/STDB calls; keep boundary at URL generation.
• Hosted reference voice sample for cloning workflows:

  https://audio.zenon.red/voice/samples/zoe-sample.mp3

  .
• For clone calls, pass

  voiceSampleUrl

  directly, or download and pass

  voiceSamplePath

  .