Omninexus MCP Hub - initial deploy (59 tools, 32 MCP servers)

README.md

@@ -0,0 +1,51 @@
+# 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)