docsorter

This project provides a JSON-RPC MCP server for working with PowerPoint files.

WILL BE CHANGED TO HEROAGENT WHICH CAN BE CALLED FROM ANYWHERE ALSO AS MCP

Installation

To get started, run the installation script and sync the dependencies using uv:

./install.sh
uv sync

Running the Server

You can run the MCP server with the following command:

uv run docsorter-server

Using the Client

The client provides a command-line interface to interact with the server.

Find Presentations

uv run docsorter-client find --start ~/Documents --pattern "*deck*.pptx"

List Slides

uv run docsorter-client list-slides --path /path/to/your/presentation.pptx

Notes on Copying Slides

The slide copying functionality is implemented in pure Python using python-pptx and direct OPC layer manipulation. While this approach supports most common content like text, shapes, and images, it has known limitations for rare or complex embedded content (e.g., OLE objects, videos).

If an unsupported content type is detected, the server will return a CopyUnsupportedError to ensure predictable behavior.