audiobook-mcp-server by joelmale - MCP Server

🎧 Audiobook Library MCP Server

Advanced MCP server for intelligent audiobook library management with AI-powered pattern recognition, web lookup capabilities, and audio processing features.

✨ Features

🧠 AI-Powered Intelligence

Web Lookup Integration - Identifies books using Google Books, Open Library, and more
Advanced Pattern Recognition - Learns your organizational preferences
Smart Entity Recognition - Extracts authors, titles, series from any filename format
Intelligent Suggestions - Context-aware recommendations with confidence scoring

🎵 Audio Processing

MP3 Combination - Merge multiple files with lossless concatenation
M4B Audiobook Creation - Professional audiobooks with metadata and chapters
Format Conversion - Support for MP3, M4A, FLAC, OGG → M4B
Automatic Chapter Markers - Generated from individual files

📚 Library Management

Audiobookshelf Compatibility - Perfect integration with Audiobookshelf
Intelligent Organization - Author-first, series-first, or hybrid structures
Bulk Operations - Process hundreds of files efficiently
Archive Handling - Extract ZIP, RAR, 7Z files automatically

🔍 Advanced Analysis

Filename Intelligence - Handles any naming convention
Metadata Enhancement - Combines file metadata with web sources
Confidence Scoring - Reliability ratings for all suggestions
Learning System - Gets smarter with every interaction

🚀 Quick Start

Prerequisites

# Install FFmpeg (required for audio processing)
brew install ffmpeg  # macOS
# or visit https://ffmpeg.org/download.html

# Verify installation
ffmpeg -version

Installation

# Clone the repository
git clone https://github.com/yourusername/audiobook-mcp-server.git
cd audiobook-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

Configuration

Set up Claude Desktop configuration at ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "audiobook-library": {
      "command": "node",
      "args": ["/path/to/audiobook-mcp-server/dist/index.js"],
      "env": {
        "AUDIOBOOK_ROOT": "/path/to/your/audiobook/library"
      }
    }
  }
}

Restart Claude Desktop
Test the connection:
```
"Scan my audiobooks library"
```

💡 Usage Examples

Basic Operations

"Scan my audiobooks library"
"Analyze my Temp folder and suggest integration"
"Extract archive files in [folder]"

AI-Powered Analysis

"Analyze this filename using web lookup: 'HP1_sorcerers_stone_jim_dale.mp3'"
"Bulk analyze my messy files and suggest proper names"
"Get smart suggestions for organizing my library"

Audio Processing

"Combine the MP3 files in this folder into one audiobook"
"Create an M4B audiobook with metadata and chapters"
"Convert this series to M4B format with proper naming"

Learning & Preferences

"Learn from this action: I renamed the file to include the author"
"Update my preferences: I prefer author-first organization"
"Show me insights about my organizing patterns"

🛠️ Available Tools

Tool	Description
`scan_library`	Recursively scan audiobook directories
`intelligent_filename_analysis`	Analyze filenames using web lookups
`smart_entity_recognition`	Identify authors, titles, series from names
`web_lookup_book`	Query web sources for book information
`bulk_filename_enrichment`	Mass analyze and suggest improvements
`combine_mp3_files`	Merge multiple MP3s into single file
`create_m4b_audiobook`	Convert to M4B with metadata and chapters
`analyze_patterns`	Deep analysis of library patterns
`smart_suggestions`	AI-powered organization recommendations
`learn_from_action`	Record user actions for learning

🌍 Web Sources

Google Books API - Comprehensive book database
Open Library - Open-source book information
LibriVox - Public domain audiobooks
Audible - Audiobook-specific data (limited)

🏗️ Architecture

src/
├── index.ts                 # Main MCP server implementation
├── WebLookupEngine         # Web API integration and caching
├── PatternRecognizer       # AI pattern detection and learning
├── SmartSuggestionEngine   # Intelligent recommendation system
└── AudiobookMCPServer      # Core server with all tool implementations

📊 Data Storage

The server creates these files in your audiobook root directory:

.mcp_learning_data.json - Pattern recognition and user actions
.mcp_user_preferences.json - Explicit user preferences
.mcp_lookup_cache.json - Cached web lookup results (7-day expiry)

All data stays local on your system - no external data transmission except for web API queries.

🔧 Development

# Development mode with auto-reload
npm run dev

# Build for production
npm run build

# Test the built server
node dist/index.js

📋 Requirements

Node.js 18.0.0 or higher
FFmpeg (for audio processing)
TypeScript 5.0.0 or higher
Claude Desktop (for MCP integration)

🤝 Contributing

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

📝 License

This project is licensed under the MIT License - see the file for details.

🙏 Acknowledgments

Model Context Protocol for the MCP framework
Google Books API for book data
Open Library for open-source book information
FFmpeg for audio processing capabilities
Audiobookshelf for inspiration on audiobook organization

📧 Support

If you encounter issues or have questions:

Check the Issues page
Create a new issue with detailed information
Include your system information and error logs

Transform your chaotic audiobook collection into a perfectly organized, AI-enhanced library! 🎧✨