MCP File Processor
Local MCP server for extracting text, keywords and chunks from files for RAG
- 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-processorAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-file-processor": {
"command": "npx",
"args": [
"-y",
"@opafex/mcp-file-processor"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-file-processor": {
"command": "npx",
"args": [
"-y",
"@opafex/mcp-file-processor"
]
}
}
}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.



