What can you do with this server?

The Icecast MCP Server analyzes and optimizes Icecast streaming server configurations through automated audits and recommendations. Core Capabilities: * Analyze Icecast XML configurations: Parse and validate configuration files to detect issues across security, performance, capacity, and reliability * Security auditing: Identify default credentials, missing authentication, weak relay passwords, and access control vulnerabilities * Performance analysis: Evaluate client limits, buffer sizes (queue/burst), thread pools, and log verbosity to identify bottlenecks * Capacity planning: Assess listener limits against expected loads and provide scaling recommendations * Reliability checks: Validate mount points, fallback configurations, and timeout settings for system resilience * Operational insights: Review hostname setup, proxy configurations (X-Forwarded-For), logging practices, and log rotation * Best practice recommendations: Receive deployment-specific guidance tailored for small (<50 listeners), medium (50-500 listeners), or large (500+ listeners) use cases * Prioritized reporting: Get structured output with CRITICAL, WARNING, and INFORMATION severity levels to prioritize fixes * Flexible deployment: Works with Claude Desktop, MCP Inspector, Docker, or any MCP-compatible client via stdio communication

Which integrations are available for this server?

Provides configuration validation for Icecast servers running behind Caddy reverse proxies, specifically checking X-Forwarded-For and hostname settings. Parses and validates Icecast configuration files in XML format to identify security vulnerabilities, performance bottlenecks, and reliability issues.

How do I use Icecast MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Icecast MCP Server analyze my icecast config at /etc/icecast.xml for 200 listeners" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

icecast-mcp

Q: Which integrations are available for this server?

Provides configuration validation for Icecast servers running behind Caddy reverse proxies, specifically checking X-Forwarded-For and hostname settings. Parses and validates Icecast configuration files in XML format to identify security vulnerabilities, performance bottlenecks, and reliability issues.

Q: How do I use Icecast MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Icecast MCP Server analyze my icecast config at /etc/icecast.xml for 200 listeners" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

MCP TypeScript License: MIT

MCP server for analyzing and optimizing Icecast streaming server configurations.

Features • Installation • Usage • Tools • Docker

Overview

A Model Context Protocol (MCP) server for analyzing Icecast streaming server configurations. Provides automated security audits, performance recommendations, and capacity planning for internet radio stations and streaming infrastructure.

Features:

Security auditing (authentication, credentials, access control)
Performance analysis (limits, buffers, threading)
Capacity planning based on listener counts
Best practice recommendations for different deployment sizes

Features

Configuration Analysis

Parse and validate Icecast XML configurations
Detect security issues (default credentials, missing authentication)
Identify performance bottlenecks (buffer sizes, thread pools, limits)
Check reliability settings (timeouts, fallback mounts)
Validate proxy configurations (X-Forwarded-For, hostname)

Best Practice Recommendations

Tailored advice for small, medium, and large deployments
Capacity planning based on expected listener counts
Security hardening guidelines
Performance tuning recommendations

What It Checks

Category	Checks
Security	Authentication config, default credentials, relay passwords, admin security
Performance	Client limits, buffer sizes (queue/burst), thread pools, log verbosity
Capacity	Listener count vs. limits, resource allocation, scaling recommendations
Reliability	Mount points, fallback configuration, timeout settings
Operations	Hostname setup, proxy config, logging, log rotation

Installation

From Source

git clone https://github.com/splinesreticulating/icecast-mcp.git cd icecast-mcp npm install npm run build

Using Docker

docker build -t icecast-mcp .

Via npm (coming soon)

npm install -g icecast-mcp

Usage

With Claude Desktop

Add to your Claude Desktop configuration file:

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

{ "mcpServers": { "icecast": { "command": "node", "args": ["/absolute/path/to/icecast-mcp/build/index.js"] } } }

Or using Docker:

{ "mcpServers": { "icecast": { "command": "docker", "args": ["run", "-i", "--rm", "-v", "/path/to/your/configs:/configs:ro", "icecast-mcp"] } } }

With MCP Inspector

Test the server locally:

npm run build npm run inspector

With Other MCP Clients

The server communicates over stdio and follows the MCP specification. Compatible with any MCP client including Claude Desktop.

Tools

`analyze_icecast_config`

Analyze an Icecast XML configuration file and receive detailed recommendations.

Input Schema:

{ "configPath": "/path/to/icecast.xml", "expectedListeners": 200 }

Parameter	Type	Required	Default	Description
`configPath`	string	Yes	-	Absolute path to Icecast XML config
`expectedListeners`	number	No	100	Expected concurrent listeners

Example Usage:

Ask Claude: "Analyze my Icecast config at /etc/icecast2/icecast.xml for 500 expected listeners"

Output Format:

# Icecast Configuration Analysis Analyzing: /etc/icecast2/icecast.xml Expected listeners: 500 ## CRITICAL ISSUES ### Security: No authentication configured Configure source-password and admin-password to secure your stream. ## WARNINGS ### Capacity: Client limit is quite low Client limit is 50. This may cause connection rejections during peak times. Current: 50 Recommended: 128 ## INFORMATION ### Configuration: X-Forwarded-For is enabled Good! This is correct when running behind a reverse proxy like Caddy.

`get_icecast_best_practices`

Get deployment-specific best practices and configuration recommendations.

Input Schema:

{ "useCase": "medium" }

Parameter	Type	Required	Options	Description
`useCase`	string	Yes	`small`, `medium`, `large`	Deployment size

Use Case Definitions:

small: < 50 concurrent listeners
medium: 50-500 concurrent listeners
large: 500+ concurrent listeners

Example Usage:

Ask Claude: "What are the best practices for a medium-sized Icecast deployment?"

Output: Comprehensive guide covering limits, security, mount points, performance, and reliability for your deployment size.

Docker

Building

docker build -t icecast-mcp .

Running with Volume Mounts

docker run -i --rm \ -v /path/to/your/icecast/config:/config:ro \ icecast-mcp

Docker Compose Example

version: '3.8' services: icecast-mcp: build: . volumes: - ./ops/icecast:/config:ro stdin_open: true tty: true

Development

# Install dependencies npm install # Run in development mode (hot reload) npm run dev # Build TypeScript npm run build # Test with MCP Inspector npm run inspector # Run tests (if available) npm test

Example Usage

A typical workflow:

Install and configure icecast-mcp
Ask Claude: "Analyze my Icecast config at /etc/icecast2/icecast.xml for 200 listeners"
Get specific recommendations:
- Optimize client limits for your traffic
- Add relay password configuration
- Configure fallback mount points
- Enable log archiving

Architecture

┌─────────────────┐ │ MCP Client │ (Claude Desktop, etc.) │ (AI Assistant) │ └────────┬────────┘ │ stdio │ ┌────────▼────────┐ │ icecast-mcp │ │ MCP Server │ ├─────────────────┤ │ • XML Parser │ │ • Analyzer │ │ • Validator │ │ • Recommender │ └────────┬────────┘ │ ▼ icecast.xml

Contributing

Contributions welcome! Areas for improvement:

Additional analysis rules
Support for more Icecast features
Performance metrics integration
Live server monitoring
Configuration generation

License

MIT License - see LICENSE file for details.

Acknowledgments

Built with @modelcontextprotocol/sdk

Icecast MCP Server

icecast-mcp

Overview

Features

Configuration Analysis

Best Practice Recommendations

What It Checks

Installation

From Source

Using Docker

Via npm (coming soon)

Usage

With Claude Desktop

With MCP Inspector

With Other MCP Clients

Tools

`analyze_icecast_config`

`get_icecast_best_practices`

Docker

Building

Running with Volume Mounts

Docker Compose Example

Development

Example Usage

Architecture

Contributing

License

Acknowledgments

Resources

Tools

New MCP Servers

Latest Blog Posts

MCP directory API