Back to the catalog

io.github.IntelagentStudios/mcp-file-processor

Text extraction, keyword extraction, language detection, and chunking for RAG

Open source Open in the app JSON README (API)

About

Text extraction, keyword extraction, language detection, and chunking for RAG

Details

Kind
MCP servers
Topic
AI, RAG & memory
Publisher
intelagentstudios
Origin
official
Category
ferramentas
Transport
local
Version
0.1.1
Last push
2026-06-28T23:54:21Z
Repository state
ativo
Language
TypeScript
License
MIT
Added
2026-08-29 03:01:58
Updated
2026-08-29 03:01:58
Origin id
io.github.IntelagentStudios/mcp-file-processor

README

# Opafex MCPs

Open-source [Model Context Protocol](https://modelcontextprotocol.io/) servers by [Opafex](https://opafex.com). Each server is a standalone npm package usable with Claude Code, Claude Desktop, Cursor, and any MCP-compatible client.

## Servers

| Package | Description | Status |
|---------|-------------|--------|
| [`@opafex/mcp-enrichment`](./packages/enrichment) | Company, contact, email & phone enrichment via Clearbit, Hunter.io, Twilio | Available |
| [`@opafex/mcp-file-processor`](./packages/file-processor) | Document text extraction, keyword detection, chunking | Available |
| `@opafex/mcp-web-research` | Web search, page fetch, research synthesis | Planned |
| `@opafex/mcp-approval-queue` | Human-in-the-loop approval workflows | Planned |
| `@opafex/mcp-knowledge-grid` | Document indexing, semantic search, context composition | Planned |

## Quick Start

```bash
# Clone and install
git clone https://github.com/opafex/opafex-mcps.git
cd opafex-mcps
npm install
npm run build

# Run the enrichment server (mock mode — no API keys needed)
node packages/enrichment/dist/index.js
```

### Add to Claude Code

Create or edit `.mcp.json` in your project root:

```json
{
  "mcpServers": {
    "enrichment": {
      "command": "node",
      "args": ["/path/to/opafex-mcps/packages/enrichment/dist/index.js"],
      "env": {
        "CLEARBIT_API_KEY": "sk-...",
        "HUNTER_API_KEY": "...",
        "TWILIO_ACCOUNT_SID": "...",
        "TWILIO_AUTH_TOKEN": "..."
      }
    }
  }
}
```

All servers work in **mock mode** when API keys are omitted — great for development and testing.

## Development

```bash
npm install          # Install all dependencies
npm run build        # Build all packages
npm test             # Run all tests
```

### Adding a New Server

1. Create `packages/<server-name>/` with `package.json`, `tsconfig.json`, and `src/`
2. Use `@opafex/mcp-shared` for the server bootstrap (`createMCPServer`)
3. Define tools in `tools.ts`, wire up in `index.ts`
4. Add tests in `__tests__/`

See [`packages/enrichment`](./packages/enrichment) as a reference implementation.

## Shared Utilities

[`@opafex/mcp-shared`](./packages/shared) provides:

- **`createMCPServer()`** — Reusable MCP server bootstrap with tool/resource registration and stdio transport
- **Validation helpers** — Email, domain, phone format validation

## License

MIT

More