Opafex MCPs
Open-source Model Context Protocol servers by Opafex. 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 | Company, contact, email & phone enrichment via Clearbit, Hunter.io, Twilio | Available | | @opafex/mcp-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
# 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.jsAdd to Claude Code
Create or edit .mcp.json in your project root:
{
"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
npm install # Install all dependencies
npm run build # Build all packages
npm test # Run all testsAdding a New Server
- Create
packages/<server-name>/withpackage.json,tsconfig.json, andsrc/ - Use
@opafex/mcp-sharedfor the server bootstrap (createMCPServer) - Define tools in
tools.ts, wire up inindex.ts - Add tests in
__tests__/
See packages/enrichment as a reference implementation.
Shared Utilities
@opafex/mcp-shared provides:
createMCPServer()— Reusable MCP server bootstrap with tool/resource registration and stdio transport- Validation helpers — Email, domain, phone format validation
License
MIT
