# io.github.jxoesneon/gemini-audio-mcp (oci · ghcr.io/jxoesneon/gemini-audio-mcp:0.1.0)

High-performance audio, music, and voice generation MCP server for Gemini 2.5 and Lyria 3.

- Trust score: 34/100 (low)
- Change this week: −5
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- oci · `ghcr.io/jxoesneon/gemini-audio-mcp:0.1.0`: 34/100 (this document), [markdown](https://verifymcp.io/servers/jxoesneon-gemini-audio-mcp/ghcr-io-jxoesneon-gemini-audio-mcp-0-1-0.md), [page](https://verifymcp.io/servers/jxoesneon-gemini-audio-mcp/ghcr-io-jxoesneon-gemini-audio-mcp-0-1-0)

## Channel facts

- Registry: `oci`
- Package: `ghcr.io/jxoesneon/gemini-audio-mcp:0.1.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 0/100
  - Malware scan not yet available for this package.
  - CVE data not yet available for this package.
  - Install-script risk not yet assessed.
  - Dependency-health data not yet available.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 121 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 60/100
  - AI-judged instruction clarity (fair).
  - Tool/resource definitions use about 856 tokens (~95/item across 9 items; 9 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 23/100
  - Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 88/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 63% of tool parameters carry a description.
- **Capabilities**: 20/100
  - Spec-recency check failed: implements MCP spec 2024-11-05; the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add jxoesneon-gemini-audio-mcp -- docker run --rm -i ghcr.io/jxoesneon/gemini-audio-mcp:0.1.0
```

### Codex

```bash
codex mcp add jxoesneon-gemini-audio-mcp -- docker run --rm -i ghcr.io/jxoesneon/gemini-audio-mcp:0.1.0
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "jxoesneon-gemini-audio-mcp": {
      "type": "local",
      "command": [
        "docker",
        "run",
        "--rm",
        "-i",
        "ghcr.io/jxoesneon/gemini-audio-mcp:0.1.0"
      ],
      "enabled": true
    }
  }
}
```

### Hermes

```yaml
mcp_servers:
  jxoesneon-gemini-audio-mcp:
    command: "docker"
    args: ["run", "--rm", "-i", "ghcr.io/jxoesneon/gemini-audio-mcp:0.1.0"]
```

### Other

```json
{
  "mcpServers": {
    "jxoesneon-gemini-audio-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/jxoesneon/gemini-audio-mcp:0.1.0"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 34, +3)

- [functional improvement] Stability: unverified → 0.23

### 2026-07-31 (score 31, −8)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-27 (score 39, +28)

- [functional improvement] Tool coverage: unverified → 100
- [functional] First check of Schema quality: fair
- [functional] First check of Tool coverage: 63
- [functional] First check of Schema quality: pass
- [functional] First check of Schema quality: fail

### 2026-07-26 (score 11)

First indexed and scored.

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

## MCP tools (9)

### `generate_soundscape` (~137 tokens)

Generates immersive, high-quality environmental soundscapes (e.g., 'A rainy forest with distant thunder'). Best for background ambience and complex layered textures. Uses Gemini 2.0 Live.

Input parameters:

- `auto_play` (boolean): If true, automatically plays the generated audio.
- `bitrate` (string)
- `channels` (number)
- `duration` (number): Optional duration in seconds. Overrides default if provided.
- `format` (string): Optional output format (wav, mp3, ogg, flac, etc.).
- `prompt` (string, required): The prompt describing the soundscape.
- `sample_rate` (number)

### `generate_voice` (~127 tokens)

Generates expressive speech and narration from text. Best for scripts, character dialogue, and narration. Uses Gemini 2.5 Native Audio.

Input parameters:

- `auto_play` (boolean): If true, automatically plays the generated audio.
- `format` (string): Optional output format (wav, mp3, ogg, flac, etc.).
- `text` (string, required): The script or text to be read by the voice.
- `voice_direction` (string): Optional instructions for the tone and style (e.g., 'Speak like a fast-talking auctioneer' or 'Use a whispery tone').

### `generate_music` (~153 tokens)

Generates full songs, loops, or musical segments. Best for melodic content, rhythm, and structured compositions. (PAID MODELS - Pro: $0.08, Clip: $0.04).

Input parameters:

- `auto_play` (boolean)
- `format` (string): Output format (wav, mp3, flac).
- `model` (string): The Lyria model to use. 'lyria-3-pro-preview' (Full songs, $0.08) or 'lyria-3-clip-preview' (30s clips, $0.04). Defaults to Pro.
- `prompt` (string, required): Detailed description of the music (e.g., 'An upbeat jazz track with a fast tempo').

### `generate_sfx` (~107 tokens)

Generates isolated, short-duration sound effects and foley (e.g., 'A laser blast' or 'Footsteps on gravel'). Best for specific one-shot audio cues. Uses Lyria-3-clip-preview ($0.04/req).

Input parameters:

- `auto_play` (boolean)
- `format` (string): Output format (wav, mp3, flac).
- `prompt` (string, required): Description of the sound effect (e.g., 'A heavy metallic door slamming shut').

### `transition_soundscape` (~92 tokens)

Generates two distinct soundscapes and creates a smooth crossfade transition between them. Ideal for evolving scenes or changing environments.

Input parameters:

- `auto_play` (boolean): If true, automatically plays the generated audio.
- `format` (string)
- `from_prompt` (string, required)
- `to_prompt` (string, required)
- `transition_duration` (number): Duration of the crossfade in seconds. Defaults to config value.

### `configure` (~124 tokens)

View or update persistent server settings like default audio format, sample rate, and automatic cleanup intervals. Call with no arguments to see current values.

Input parameters:

- `auto_cleanup_hours` (number): How often to clean up old audio files (in hours).
- `default_bitrate` (string)
- `default_channels` (number)
- `default_duration` (number): Default duration for soundscapes in seconds.
- `default_format` (string): Default file extension (e.g., 'mp3').
- `default_sample_rate` (number)
- `default_transition_duration` (number)

### `play_audio` (~46 tokens)

Plays any local audio file using the system's default media player (e.g., 'afplay' on macOS).

Input parameters:

- `path` (string, required): The absolute path to the audio file.

### `cleanup_assets` (~46 tokens)

Manually trigger deletion of generated audio assets that exceed a certain age (in hours) to save disk space.

Input parameters:

- `max_age_hours` (number): Files older than this will be deleted.

### `check_dependencies` (~24 tokens)

Verifies that the system has required external tools like FFmpeg installed and accessible.

## Diagnostics

Captured diagnostic sections: Provenance. The full working is on the page: https://verifymcp.io/servers/jxoesneon-gemini-audio-mcp/ghcr-io-jxoesneon-gemini-audio-mcp-0-1-0#diagnostics

## Score history

- 2026-08-03: 34
- 2026-08-02: 31
- 2026-08-01: 31
- 2026-07-31: 31
- 2026-07-30: 39
- 2026-07-29: 39
- 2026-07-28: 39
- 2026-07-27: 39
- 2026-07-26: 11

## Links

- Repository: https://github.com/jxoesneon/gemini-audio-mcp
- Changelog RSS feed: https://verifymcp.io/servers/jxoesneon-gemini-audio-mcp/ghcr-io-jxoesneon-gemini-audio-mcp-0-1-0/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/jxoesneon-gemini-audio-mcp/ghcr-io-jxoesneon-gemini-audio-mcp-0-1-0/changelog.json
- HTML version of this page: https://verifymcp.io/servers/jxoesneon-gemini-audio-mcp/ghcr-io-jxoesneon-gemini-audio-mcp-0-1-0