Ekstrak teks, kata kunci, dan informasi bahasa dari berbagai format file serta melakukan chunking teks untuk pipeline RAG.
Juga dikenal sebagai IntelagentStudios/Intelagent-MCPs, @intelagent/mcp-file-processor
- Stars
- 0
- Tools
- 4
- Unduhan, 30 hari
- 178
- Versi terbaru
- 0.1.1
- Commit terakhir
- 13 Nov 2026
- Lisensi
- MIT
Apa itu file-processor MCP?
file-processor adalah MCP server. Ekstrak teks, kata kunci, dan informasi bahasa dari berbagai format file serta melakukan chunking teks untuk pipeline RAG. Server ini menyediakan 4 tool, seperti content, text, limit.
Ringkasan dibuat dari README proyek
Tentang file-processor MCP server
Server ini memungkinkan developer untuk mempersiapkan dokumen guna kebutuhan pipeline retrieval-augmented generation. Server ini menyediakan cara untuk mengubah berbagai format file menjadi data teks terstruktur yang dapat dengan mudah diindeks atau dianalisis. Dengan menggunakan tool seperti extract_text dan chunk_text, Anda dapat mengonversi file biner seperti PDF dan DOCX atau file berbasis teks seperti Markdown dan CSV menjadi segmen yang mudah dikelola untuk model embedding.
Berjalan secara lokal melalui Node.js 20+, server ini tidak memerlukan API key atau akun eksternal untuk berfungsi. Server ini dapat diintegrasikan ke dalam Claude Desktop atau Claude Code menggunakan npx. Server ini menawarkan kemampuan khusus seperti detect_language untuk membedakan antara bahasa alami dan bahasa pemrograman seperti TypeScript atau Python, serta extract_keywords untuk mengidentifikasi istilah yang sering muncul dalam sebuah teks. Untuk alur kerja yang lebih efisien, tool process_file menggabungkan proses ekstraksi, deteksi bahasa, pemeringkatan kata kunci, dan text chunking ke dalam satu perintah tunggal.
Apa yang bisa Anda lakukan dengannya
- 1Persiapkan teks untuk RAGMemecah dokumen besar menjadi segmen yang tumpang tindih untuk meningkatkan akurasi retrieval pada pipeline embedding.
- 2Identifikasi bahasa pemrogramanMenentukan apakah sebuah file berisi bahasa alami atau kode spesifik seperti Java atau Rust.
- 3Ringkas topik dokumenMenghasilkan daftar peringkat kata kunci yang paling sering muncul dalam teks tertentu.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal file-processor MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal file-processor MCP di Claude Code
$ claude mcp add mcp-file-processor -- npx -y @intelagent/mcp-file-processorInstal file-processor MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-file-processor": {
"command": "npx",
"args": [
"-y",
"@intelagent/mcp-file-processor"
]
}
}
}Instal file-processor MCP di VS Code
.vscode/mcp.json
{
"servers": {
"mcp-file-processor": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@intelagent/mcp-file-processor"
]
}
}
}Instal file-processor MCP di VS Code CLI
$ code --add-mcp '{"name":"mcp-file-processor","type":"stdio","command":"npx","args":["-y","@intelagent/mcp-file-processor"]}'Instal file-processor MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp-file-processor": {
"command": "npx",
"args": [
"-y",
"@intelagent/mcp-file-processor"
]
}
}
}Instal file-processor MCP di Codex
$ codex mcp add mcp-file-processor -- npx -y @intelagent/mcp-file-processorInstal file-processor MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp-file-processor] command = "npx" args = ["-y", "@intelagent/mcp-file-processor"]
Instal file-processor MCP di Gemini CLI
$ gemini mcp add -s user mcp-file-processor npx -- -y @intelagent/mcp-file-processorInstal file-processor MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp-file-processor": {
"command": "npx",
"args": [
"-y",
"@intelagent/mcp-file-processor"
]
}
}
}Tool file-processor MCP 4
Terdeteksi dari READMEcontenttextlimitoverlap
| content | — | |
| text | — | |
| limit | — | |
| overlap | — |
Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Lolos checks otomatis kami. Ini bukan audit keamanan: baca kodenya dan berikan server akses paling terbatas yang dibutuhkannya. Cara kerja checks
- Source repository terhubung dan dapat dijangkauintelagentstudios/intelagent-mcps is public and reachablegithub.com/intelagentstudios/intelagent-mcps ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernya@intelagent/mcp-file-processor names intelagentstudios/intelagent-mcps as sourcenpmjs.com/package/@intelagent/mcp-file-processor ↗Lolos
- Provenance build (atestasi Sigstore)No build attestation published for this releaseTidak diperiksa
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-11-09github.com/intelagentstudios/intelagent-mcps ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerNo popular package one edit away from @intelagent/mcp-file-processorLolos
- Tidak ada advisory kritis pada paket atau dependensinya125 resolved dependencies checked; no critical advisoryosv.dev ↗Lolos
- Tidak ada instruksi tersembunyi untuk model4 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelNo tool named like delete, drop or execLolos
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di 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.
Pertanyaan tentang file-processor MCP
Bagaimana cara menambahkan file-processor MCP ke Claude Code?
Jalankan claude mcp add mcp-file-processor -- npx -y @intelagent/mcp-file-processor di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan file-processor MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Tool apa yang disediakan file-processor MCP?
Server ini menyediakan 4 tool, termasuk content, text, limit, overlap.
Format file apa saja yang didukung?
Server ini mendukung PDF, DOCX, CSV, JSON, Markdown, HTML, XML, dan berbagai bahasa pemrograman seperti JavaScript, TypeScript, Python, Java, Go, Rust, dan C/C++.
Apakah saya memerlukan API key untuk menggunakan server ini?
Tidak, server ini berjalan secara lokal dan tidak memerlukan API key apa pun.
Apa saja persyaratan sistemnya?
Anda perlu menginstal Node.js versi 20 atau yang lebih tinggi.
Apakah bisa digunakan untuk pipeline RAG?
Ya, server ini menyertakan tool untuk text chunking dengan segmen yang tumpang tindih (overlapping) yang dirancang khusus untuk pipeline RAG dan embedding.