Skip to main content

A Model Context Protocol (MCP) server for reading and summarizing file content with language support

Project description

📄 File Summarizer MCP Server

A fully offline, multi-modal file summarization server built with FastMCP. Supports text, documents, audio, and video files with language detection, translation, and speech-to-text capabilities.

🚀 Features

  • 📂 Reads multiple file types — PDF, DOCX, TXT, audio (MP3, WAV), video (MP4, MOV) via Apache Tika & Whisper.
  • 🧠 Summarizes file content or raw input text automatically.
  • 🌐 Multi-language support — detects input language, translates to English if needed, or keeps summary in original language.
  • 🎙 Speech-to-text transcription — audio/video files transcribed via Whisper before summarization.
  • ⚙️ Simple async MCP tools — easy to extend and integrate with any MCP client.
  • 🔒 Fully offline capable — no need for external LLM APIs.
  • 🐍 Built with Python 3.12, FastMCP server framework, Apache Tika, Whisper, LangDetect, and Deep Translator.

🛠 Installation

1️⃣ Clone the repo:

git clone https://github.com/Muskan244/File_Summarizer_MCP_Server.git
cd File_Summarizer_MCP_Server

2️⃣ Setup virtual environment:

python3.12 -m venv .venv
source .venv/bin/activate

3️⃣ Install dependencies:

pip install -r requirements.txt
# Whisper requires ffmpeg installed system-wide
brew install ffmpeg  # (Mac)

🔧 Usage

Start the MCP server:

uv run file_summarizer.py

It exposes the following tools:

  • read_file(file_path)
  • summarize_file(file_path)
  • summarize_text(text)
  • detect_language(text)
  • translate_text(text)
  • transcribe_file(file_path)

You can invoke these via any MCP-compliant client (Claude Desktop, Open Interpreter, etc.).

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

file_summarizer_mcp_server-0.1.1.tar.gz (4.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

file_summarizer_mcp_server-0.1.1-py3-none-any.whl (4.9 kB view details)

Uploaded Python 3

File details

Details for the file file_summarizer_mcp_server-0.1.1.tar.gz.

File metadata

File hashes

Hashes for file_summarizer_mcp_server-0.1.1.tar.gz
Algorithm Hash digest
SHA256 9ad4e1775a5c30f3d620d48fb1b3789a401e4effa616e295aa56bedc62dbb49a
MD5 0b2ef26e4fc0bec678390d2fc6ec74cf
BLAKE2b-256 e907775e4faa479d2759d29e108d5462113f1d2fe22d4783561d5a44da1e4e03

See more details on using hashes here.

File details

Details for the file file_summarizer_mcp_server-0.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for file_summarizer_mcp_server-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 bd8154a5c0f051bb1116c08b62c50e0d96faf6dea73d6e97d55396edc8c08627
MD5 59ac71c42ed28b888be4a857ab6f8f8a
BLAKE2b-256 049c72e564a04dd2225e4938bba1c71bcd6014cff1f1cbc3bff91a0fecec75d5

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page