Directmedia

Provides programmatic access to Directmedia Digitale Bibliothek for text extraction, navigation, and EPUB conversion.

python

0

GitHub Stars

python

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "sandraschi-directmedia-mcp": {
      "command": "python",
      "args": [
        "-m",
        "directmedia_mcp.server",
        "--library-path",
        "L:\\Multimedia Files\\Written Word\\Digitale Bibliothek"
      ]
    }
  }
}

You can programmatically access and extract text from Directmedia Publishing's historic Digitale Bibliothek collection using this MCP server. It provides commands to manage volumes, search for German literature, extract text, navigate contents, and convert volumes to EPUB for modern reading, all through a simple MCP interface.

How to use

Start the MCP server using one of the available local (stdio) commands, then interact with it through your MCP client or tooling. You can list volumes, search for content, extract text, view the table of contents, and convert volumes to EPUB.

Examples of common workflows you can perform after starting the server include listing volumes, searching for specific terms, extracting text ranges, and converting volumes to EPUB format. The server exposes dedicated tools for these tasks as described in the tool list.

Convert a single volume to EPUB and batch convert multiple volumes using the provided MCP tools. These operations produce modern EPUB files suitable for popular readers and libraries.

How to install

Prerequisites: Python 3.11+ must be installed on your system.

Install the MCP package in editable mode from your source tree or distribution so you can run the MCP server and its tools locally.

pip install -e .

Configuration and usage notes

You run the MCP server with the library path to the Directmedia Digitale Bibliothek collection on your filesystem. Two equivalent startup options are shown below.

python -m directmedia_mcp.server --library-path "L:\Multimedia Files\Written Word\Digitale Bibliothek"

directmedia-mcp --library-path "L:\Multimedia Files\Written Word\Digitale Bibliothek"

MCP tools and how to use them

Library management tools let you configure the library location and inspect volumes.

Content access tools enable text search and extraction across volumes.

EPUB conversion tools create EPUB 3.0 files from extracted text, with proper metadata and table of contents.

Note: Use the following representative tool calls to perform common tasks.

convert_volume_to_epub_file("DB002", "./epub_output")
batch_convert_to_epub("./epub_library", ["DB002", "DB003", "DB004"])

Security, legality, and notes

You must legally own copies of Directmedia Publishing's Digitale Bibliothek CD-ROMs to use this toolset.

This tool is intended for educational and research use with legally obtained content. Adhere to copyright laws in your jurisdiction.

Troubleshooting and tips

If you encounter path or encoding issues, ensure the library path is correct and that the Latin-1 text in the source volumes is properly handled by your environment.

Available tools

set_library_path

Configure the library location so the MCP server can locate the Directmedia Digitale Bibliothek collection.

list_volumes

List all available volumes in the library with their metadata.

get_volume_info

Retrieve metadata for a specific volume identified by its ID.

search_text

Search across volumes for a text query, optionally scoped to a specific volume and limited by a count.

get_text_content

Extract a span of text from a specified volume using a start position and length.

get_navigation_tree

Obtain the table of contents or navigation structure for a volume.

convert_volume_to_epub_file

Convert a single volume to a standards-compliant EPUB file and save it to a chosen directory.

batch_convert_to_epub

Convert multiple volumes to EPUB in a batch operation and save them to a directory.

analyze_volume_structure

Analyze the file format structure of a volume for troubleshooting or research.