52 lines
2.2 KiB
Markdown
52 lines
2.2 KiB
Markdown
# 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)
|