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.0.tar.gz (52.3 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.0-py3-none-any.whl (4.0 kB view details)

Uploaded Python 3

File details

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

File metadata

File hashes

Hashes for file_summarizer_mcp_server-0.1.0.tar.gz
Algorithm Hash digest
SHA256 0d8274906bab08c362c170efb73560e6ac6d3f90125ee442c18f54f756d771bd
MD5 d56654d99367339e62304d172bff9b39
BLAKE2b-256 71eee910a59b4e630191ec920656ab92c90e766c6177c0c3a934c18547651932

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for file_summarizer_mcp_server-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 cf70e8c08f8981e3b1c86348006b8fa2eef502d199be1a2b0902b1503c94bbc1
MD5 74d18ab91e6c6cb2588075abb52bcaac
BLAKE2b-256 222cd37f937b41e56427366831fed326b1b8260dfc6c2d32a6a58b231e978920

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