Extract text, keywords, and language information from various file formats and chunk text for RAG pipelines.
Also known as IntelagentStudios/Intelagent-MCPs, @intelagent/mcp-file-processor
- Stars
- 0
- Tools
- 4
- Downloads, 30 days
- 178
- Latest version
- 0.1.1
- Last commit
- Nov 13, 2026
- License
- MIT
What is file-processor MCP?
file-processor extracts text, keywords, and language information from various file formats and chunk text for RAG pipelines. It exposes 4 tools, such as content, text, limit.
Summary generated from the project's README
About file-processor MCP server
Preparing documents for retrieval-augmented generation pipelines is what this server enables for developers. It provides a way to transform various file formats into structured text data that can be easily indexed or analyzed. By using tools like extract_text and chunk_text, users can convert binary files like PDF and DOCX or text-based files like Markdown and CSV into manageable segments for embedding models.
Running locally via Node.js 20+, this server requires no API keys or external accounts to function. It can be integrated into Claude Desktop or Claude Code using npx. The server offers specialized capabilities such as detect_language to distinguish between natural language and programming languages like TypeScript or Python, and extract_keywords to identify frequent terms within a text. For a streamlined workflow, the process_file tool combines extraction, language detection, keyword ranking, and text chunking into a single command.
What you can do with it
- 1Prepare text for RAGSplit large documents into overlapping segments to improve retrieval accuracy in embedding pipelines.
- 2Identify programming languagesDetermine if a file contains natural language or specific code like Java or Rust.
- 3Summarize document topicsGenerate a ranked list of the most frequent keywords found in a specific text.
Written from the project's README. Every use case is checked against a quote from it.
How to install file-processor MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall file-processor MCP in Claude Code
$ claude mcp add mcp-file-processor -- npx -y @intelagent/mcp-file-processorInstall file-processor MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-file-processor": {
"command": "npx",
"args": [
"-y",
"@intelagent/mcp-file-processor"
]
}
}
}Install file-processor MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp-file-processor": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@intelagent/mcp-file-processor"
]
}
}
}Install file-processor MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp-file-processor","type":"stdio","command":"npx","args":["-y","@intelagent/mcp-file-processor"]}'Install file-processor MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp-file-processor": {
"command": "npx",
"args": [
"-y",
"@intelagent/mcp-file-processor"
]
}
}
}Install file-processor MCP in Codex
$ codex mcp add mcp-file-processor -- npx -y @intelagent/mcp-file-processorInstall file-processor MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp-file-processor] command = "npx" args = ["-y", "@intelagent/mcp-file-processor"]
Install file-processor MCP in Gemini CLI
$ gemini mcp add -s user mcp-file-processor npx -- -y @intelagent/mcp-file-processorInstall file-processor MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp-file-processor": {
"command": "npx",
"args": [
"-y",
"@intelagent/mcp-file-processor"
]
}
}
}file-processor MCP tools 4
Detected from the READMEcontenttextlimitoverlap
| content | — | |
| text | — | |
| limit | — | |
| overlap | — |
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachableintelagentstudios/intelagent-mcps is public and reachablegithub.com/intelagentstudios/intelagent-mcps ↗Pass
- Package names this repository as its source@intelagent/mcp-file-processor names intelagentstudios/intelagent-mcps as sourcenpmjs.com/package/@intelagent/mcp-file-processor ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-09github.com/intelagentstudios/intelagent-mcps ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @intelagent/mcp-file-processorPass
- No critical advisory in the package or its dependencies125 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model4 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHub@opafex/mcp-file-processor
MCP server for universal text extraction, keyword extraction, language detection, and text chunking — designed for RAG pipelines.
Supports PDF, DOCX, CSV, JSON, Markdown, HTML, and code files. Zero platform dependencies.
Installation
npm install @opafex/mcp-file-processor
Requires Node.js 20+.
Quick Start
Add to Claude Code / Claude Desktop
{
"mcpServers": {
"file-processor": {
"command": "npx",
"args": ["@opafex/mcp-file-processor"]
}
}
}
No API keys needed — everything runs locally.
Tools
extract_text
Extract text content from a file.
| Parameter | Type | Required | Description |
|---|---|---|---|
content |
string | Yes | File content — base64 for binary formats (PDF, DOCX), raw text for text formats |
fileType |
string | Yes | MIME type (e.g. "application/pdf") or extension (e.g. ".pdf", "pdf") |
{
"success": true,
"text": "Extracted text content here...",
"wordCount": 142,
"pageCount": 3,
"processingTimeMs": 45
}
extract_keywords
Extract ranked keywords from text. Filters stop words, sorted by frequency.
| Parameter | Type | Required | Description |
|---|---|---|---|
text |
string | Yes | Text to extract keywords from |
limit |
number | No | Max keywords to return (default: 20) |
{
"success": true,
"keywords": [
{ "word": "javascript", "frequency": 8 },
{ "word": "framework", "frequency": 4 },
{ "word": "react", "frequency": 3 }
],
"totalWords": 156
}
detect_language
Detect whether content is code, natural language, or mixed.
| Parameter | Type | Required | Description |
|---|---|---|---|
text |
string | Yes | Text to analyse |
fileName |
string | No | File name for extension-based detection (e.g. "app.ts") |
{
"success": true,
"contentType": "code",
"programmingLanguage": "typescript"
}
chunk_text
Split text into overlapping chunks for RAG/embedding pipelines.
| Parameter | Type | Required | Description |
|---|---|---|---|
text |
string | Yes | Text to chunk |
chunkSize |
number | No | Target chunk size in characters (default: 1000) |
overlap |
number | No | Overlap between chunks in characters (default: 200) |
{
"success": true,
"chunks": [
{ "index": 0, "text": "...", "startOffset": 0, "endOffset": 1000, "wordCount": 167 },
{ "index": 1, "text": "...", "startOffset": 800, "endOffset": 1800, "wordCount": 172 }
],
"totalChunks": 5,
"totalCharacters": 4200
}
process_file
All-in-one: extract text, detect content type, extract keywords, and chunk.
| Parameter | Type | Required | Description |
|---|---|---|---|
content |
string | Yes | File content (base64 or raw text) |
fileType |
string | Yes | MIME type or file extension |
chunkSize |
number | No | Chunk size in characters (default: 1000) |
chunkOverlap |
number | No | Overlap in characters (default: 200) |
keywordLimit |
number | No | Max keywords (default: 20) |
server_info (built-in)
Returns server metadata, registered tools, and resources.
Resources
| Resource | Description |
|---|---|
file-processor://supported-types |
Lists all supported MIME types and file extensions |
Supported Formats
| Format | Extension | Input |
|---|---|---|
.pdf |
base64 | |
| Word | .docx, .doc |
base64 |
| Plain text | .txt |
raw text |
| Markdown | .md |
raw text |
| CSV | .csv |
raw text |
| JSON | .json |
raw text |
| HTML | .html |
raw text |
| XML | .xml |
raw text |
| JavaScript | .js, .jsx, .mjs |
raw text |
| TypeScript | .ts, .tsx |
raw text |
| Python | .py |
raw text |
| Java | .java |
raw text |
| Go | .go |
raw text |
| Rust | .rs |
raw text |
| C/C++ | .c, .cpp, .h |
raw text |
Development
npm run build # Compile TypeScript
npm run dev # Run with tsx
npm test # Run tests
npm start # Run compiled server
Library Usage
import { FileProcessorService } from '@opafex/mcp-file-processor/service';
const service = new FileProcessorService();
const result = await service.processFile(
'Hello world, this is a document.',
'.txt',
500, // chunk size
100 // overlap
);
Contributing
Found a bug or have a feature request? Open an issue.
License
MIT — see LICENSE.
file-processor MCP questions
How do I add file-processor MCP to Claude Code?
Run claude mcp add mcp-file-processor -- npx -y @intelagent/mcp-file-processor in your terminal. Add --scope user to make it available in every project.
How do I add file-processor MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does file-processor MCP provide?
It exposes 4 tools, including content, text, limit, overlap.
What file formats are supported?
The server supports PDF, DOCX, CSV, JSON, Markdown, HTML, XML, and various programming languages like JavaScript, TypeScript, Python, Java, Go, Rust, and C/C++.
Do I need an API key to use this server?
No, the server runs locally and does not require any API keys.
What are the system requirements?
You need Node.js version 20 or higher installed.
Can it be used for RAG pipelines?
Yes, it includes tools for text chunking with overlapping segments specifically designed for RAG and embedding pipelines.