MCP服务器集合

Opafex 提供一套开源 MCP(Model Context Protocol)服务器,涵盖企业信息丰富、文件处理、网络研究与人工审批等核心功能,适用于 Claude Code、Cursor 等支持 MCP 的客户端。

  • by Opafex
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 IntelagentStudios/Intelagent-MCPs

使用说明

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 (Brave API), SSRF-guarded page fetch, research synthesis Available
@opafex/mcp-approval-queue Human-in-the-loop approval gate — the agent asks, only a person approves (elicitation or CLI) Available
@opafex/knowledge-grid Layered context for agents (a library, in its own repo) Available

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.js

Add 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 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 as a reference implementation.

Shared Utilities

@opafex/mcp-shared provides:

  • createMCPServer() / buildMCPServer() — Reusable MCP server bootstrap with tool/resource registration and stdio transport
  • ToolContext.elicit — ask the user a question through the client's UI (MCP elicitation), out of the model's reach
  • Validation helpers — Email, domain, phone format validation

License

MIT