# Omninexus MCP Hub

A self-hosted **universal MCP hub** and central tool source-of-truth for AI agents. Exposes 59 live tools across 32 preset MCP servers over REST, JSON-RPC 2.0, and Server-Sent Events (SSE), plus a memory vault, security gateway, workflow pipelines, and an AI prompt-to-tool studio.

## Capabilities

- **MCP Server Registry** — 32 preset servers (built-in core suite, Ollama/GPU delegation, NVIDIA NIM, weather, crypto, HackerNews, JS evaluator, JSON/regex utilities, and more) with full CRUD, import/export, toggle, and ping.
- **59 native tools** — web scraping, JS execution, math, chart generation, data conversion, code review, task decomposition, and the in-memory vault.
- **Memory Vault** — key/value store with tags, TTL, search, and per-agent attribution.
- **Security Gateway** — scoped access keys, rate limiting, and optional Bearer-token enforcement.
- **Workflow Pipelines** — compose and execute multi-tool pipelines.
- **AI Tool Studio** — generate MCP tool configs from natural-language prompts (requires `GEMINI_API_KEY`).
- **Transports** — MCP JSON-RPC 2.0 (`POST /mcp`), SSE (`GET /mcp/sse`), and REST v1 (`/api/v1/*`).

## Quick Start

```bash
npm install
npm run build      # vite build + esbuild -> dist/server.cjs
NODE_ENV=production node dist/server.cjs   # listens on :3000
```

Development:
```bash
npm run dev        # tsx server.ts with Vite HMR
```

## Endpoints

| Endpoint | Description |
|----------|-------------|
| `GET /api/v1/system/status` | Health, uptime, tool/server counts |
| `GET /api/v1/tools` | Full tool catalog |
| `POST /api/v1/tools/:name` | Execute a tool over REST |
| `GET /api/v1/mcp/servers` | Registry CRUD |
| `GET /mcp/sse` | MCP Server-Sent Events stream |
| `POST /mcp` | MCP JSON-RPC 2.0 endpoint |
| `GET /openapi.json` | OpenAPI 3.0 spec |
| `GET /api/v1/memory` | Memory vault |

## Configuration

Set `GEMINI_API_KEY` in `.env.local` to enable the AI prompt-to-tool generator. All other features run without any external key.

## Stack

React 19 · Vite 6 · Express 4 · TypeScript · Tailwind CSS 4 · Recharts · `@google/genai`

---

Support this project: [Buy Me a Coffee](https://buymeacoffee.com/r26xrthzttg)