# Phosphor

> Async Python IRC client with Textual TUI, magic-wormhole P2P transfers, MCP AI integration, and retro Teletext dashboard. Modern UX at 1/100th the memory

- **Type:** MCP server
- **Install:** `agentstack add mcp-crypticsaiyan-phosphor`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [crypticsaiyan](https://agentstack.voostack.com/s/crypticsaiyan)
- **Installs:** 0
- **Category:** [Cloud & Infrastructure](https://agentstack.voostack.com/c/cloud-infrastructure)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [crypticsaiyan](https://github.com/crypticsaiyan)
- **Source:** https://github.com/crypticsaiyan/phosphor

## Install

```sh
agentstack add mcp-crypticsaiyan-phosphor
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# phosphor

> Discord UX + IRC Protocol = Terminal Magic

A resurrection of IRC with Discord's user experience, running in a high-performance Terminal UI. Proves that modern collaboration doesn't need 2GB of RAM—it just needs better design.

## 🚀 Quick Start

```bash
# Setup (one time)
./setup.sh

# Run
python -m src.main

# Try it
# - Chat in real IRC channels (#python, #linux, #programming)
# - See live member lists in the sidebar
# - Press F1 for Teletext dashboard
# - Type /ai docker-stats
# - Type /send demo.txt
```

## ✨ Features

### 🎨 Discord-Like Interface
Beautiful 3-pane layout with channels, chat, and members. Markdown support, syntax highlighting, and rich embeds.

### 📺 Teletext Dashboard (F1) - Page 100
Authentic 1980s Ceefax/Oracle aesthetic with modern DevOps data. Features:
- Ticking clock (seconds update in real-time)
- ASCII CPU/Memory graphs using `psutil`
- Container status matrix with colored blocks
- Git commits as "Breaking News" headlines
- Scrolling ticker tape with error logs
- Strict 8-color palette (Black, White, Red, Green, Blue, Cyan, Magenta, Yellow)
- Block graphics (█ ▀ ▄ ░) for authentic retro feel

### 🔐 Wormhole File Transfer
Peer-to-peer encrypted file transfers with human-readable codes. No cloud, no traces, just magic.

### 🔊 Geiger Counter Audio
Audio feedback for system health. Hear errors before you see them. Escalating sounds for increasing error rates.

### 🤖 MCP Integration
AI-powered commands via Model Context Protocol. Extensible tool system for automation.

## 📊 Performance

| Metric | Discord | phosphor |
|--------|---------|----------|
| Memory | 2GB | 20MB |
| Startup | 10s | ` | Send file via wormhole |
| `/grab ` | Receive file via wormhole |
| `/ai [query]` | DevOps Health Bot - Check Docker containers |

## 🤖 DevOps Health Bot

phosphor includes an AI-powered DevOps assistant that automatically monitors Docker container health:

```bash
# In the TUI or via IRC:
/ai                    # Check all containers
/ai prod               # Check production
/ai staging web        # Check staging web service
```

**Features:**
- 🏥 Automatic health assessment (healthy, warning, critical)
- 🔍 Smart filtering by environment (prod, staging) and service (web, api, db)
- 📊 Monitors status, health checks, restarts, CPU, memory
- 💬 IRC-friendly output with emojis and actionable recommendations
- 🔒 Read-only, safe operations

## 🛠️ Tech Stack

- **Python 3.11+** - Language
- **Textual** - Modern TUI framework
- **bottom** - Async IRC library
- **magic-wormhole** - P2P file transfers
- **simpleaudio** - Audio feedback
- **plotext** - ASCII charts
- **MCP** - AI integration with Docker monitoring

## 📁 Project Structure

```
phosphor/
├── src/
│   ├── core/          # Backend (IRC, MCP, Wormhole, Audio)
│   └── ui/            # Frontend (Textual TUI)
├── assets/
│   ├── screenshots/   # UI screenshots
│   └── logo.txt       # ASCII logo
├── setup.sh           # One-time setup script
└── ARCHITECTURE.md    # Technical deep dive
```

## 🏆 Why phosphor?

- **Efficient**: 1/100th the memory of Discord
- **Fast**: Sub-second startup, zero-latency UI
- **Open**: Built on IRC, the original open protocol
- **Innovative**: Only chat app with audio feedback
- **Beautiful**: Discord's UX in your terminal
- **Practical**: Actually solves real problems

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [crypticsaiyan](https://github.com/crypticsaiyan)
- **Source:** [crypticsaiyan/phosphor](https://github.com/crypticsaiyan/phosphor)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** yes
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-crypticsaiyan-phosphor
- Seller: https://agentstack.voostack.com/s/crypticsaiyan
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.