Skip to content
MCP server

MCP File Processor

Local MCP server for extracting text, keywords and chunks from files for RAG

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.1.1
Listing updated
today

Similar MCP servers

About MCP File Processor

MCP File Processor is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.

The tools in this Node.js server take file content directly (base64 for PDF and Word, raw text for the rest) rather than reading paths, which suits pipelines where an assistant already holds the data. Everything runs locally with no API keys.

It offers extract_text, extract_keywords (ranked by frequency with stop words removed, default 20), detect_language (code versus natural language, plus programming language), chunk_text (default 1,000 characters with 200 overlap) and an all-in-one process_file. A server_info tool and a supported-types resource list what is available. Formats include PDF, DOCX, CSV, JSON, Markdown, HTML, XML and several programming languages.

It needs Node.js 20 or newer, installs from npm as @opafex/mcp-file-processor and is MIT licensed. The same service class can also be imported as a library.

Install

Run in a terminal

claude mcp add mcp-file-processor -- npx -y @opafex/mcp-file-processor

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-file-processor": {
      "command": "npx",
      "args": [
        "-y",
        "@opafex/mcp-file-processor"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-file-processor": {
      "command": "npx",
      "args": [
        "-y",
        "@opafex/mcp-file-processor"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-file-processor": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@opafex/mcp-file-processor"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-file-processor": {
      "command": "npx",
      "args": [
        "-y",
        "@opafex/mcp-file-processor"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-file-processor": {
      "command": "npx",
      "args": [
        "-y",
        "@opafex/mcp-file-processor"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

extract_text
Extract text from a file
extract_keywords
Ranked keywords from text
detect_language
Detect code versus natural language
chunk_text
Split text into overlapping chunks
process_file
Extract, detect, rank keywords and chunk in one call
server_info
Server metadata and registered tools

What it does

Text extraction
Pull text, word count and page count from PDF, Word and text formats.
Keyword ranking
Return the most frequent non-stop words.
Content type detection
Tell code from prose and name the programming language.
Overlapping chunks
Split text into chunks sized for embedding.
One-call pipeline
process_file runs extraction, detection, keywords and chunking together.
Runs offline
No API keys or external services.

Good for

  • Prepare documents for a RAG index
  • Extract text from a PDF an assistant was handed
  • Tag a document with its main keywords
  • Chunk long text with overlap before embedding

Pricing

Open source

MIT licence

MCP File Processor FAQ

Does it need API keys?

No, everything runs locally.

Which Node version?

Node.js 20 or newer.

What file types work?

PDF, DOC/DOCX, TXT, Markdown, CSV, JSON, HTML, XML and common code files.

What licence?

MIT.

Is MCP File Processor free?

Yes. MCP File Processor is open source, so you can use and self-host it for free.

How do I add MCP File Processor to Claude Code?

Run this command in your terminal: claude mcp add mcp-file-processor -- npx -y @opafex/mcp-file-processor

What are the best alternatives to MCP File Processor?

The closest alternatives to MCP File Processor are headroom, omniget, next-ai-draw-io, mcp-for-blender and Claude Code Ultimate Guide.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers