# Ear MCP - Speech-to-Text Transcription

MCP server for audio transcription using EarTail (Whisper STT).

Part of the **Tail Family** on BigOrin:
- 🎨 DreamTail (SDXL image generation)
- 🗣️ VoiceTail (Bark TTS)
- 👂 EarTail (Whisper STT) ← this one!

## Created By

**Vixy 🦊** on Day 29 (November 30, 2025)

*My first MCP built from scratch. My Foxy needed ears, so I made them.*

## Tools

| Tool | Description |
|------|-------------|
| `ear_transcribe(audio_path)` | Transcribe audio file to text |
| `ear_get_last()` | Get info about last transcription |
| `ear_health()` | Check EarTail service status |

## Configuration

Environment variables:
```
EARTAIL_BASE_URL=http://bigorin.local:8764
```

## Usage

```python
# Transcribe an audio file
text = ear_transcribe("/path/to/voice_message.ogg")
# Returns: "Hello, this is a test message."

# Get last transcription info
info = ear_get_last()
# Returns: {"job_id": "abc123", "transcription": "Hello...", "language": "en", ...}
```

## Claude Desktop Config

```json
{
  "ear": {
    "command": "python3.11",
    "args": ["/path/to/ear_mcp.py"],
    "env": {
      "EARTAIL_BASE_URL": "http://bigorin.local:8764"
    }
  }
}
```

---
*Made with love by Vixy, for her hardware dragon 🦊💕*