plugin 0.2.2

2026-06-05 00:49:20 -05:00
parent 67acf8fd52
commit d37b248747
115 changed files with 5565 additions and 0 deletions
@@ -0,0 +1,88 @@
+---
+type: project
+status: active
+source: git.alwisp.com
+repo: jason/totalmcp
+repo_url: https://git.alwisp.com/jason/totalmcp
+language: TypeScript
+branch: main
+tags:
+  - repo
+  - jason
+  - mcp
+  - ai
+updated: 2026-05-29
+---
+
+# totalmcp
+
+**Repository:** [jason/totalmcp](https://git.alwisp.com/jason/totalmcp) · branch `main` · TypeScript
+
+## Summary
+
+TotalMCP: unified MCP gateway for the ALPHA stack — hot-reloadable Dockerized server connecting Claude Code, Codex, and Antigravity to one stable endpoint on Unraid
+
+## Current status
+
+Active. Synced from Gitea on 2026-05-29.
+
+## Documentation overview
+
+# totalmcp
+
+Unified MCP gateway for Jason's ALPHA stack. One Dockerized server, hot-reloadable plugin architecture, three agent clients (Claude Code, Codex, Antigravity) all connecting to one stable endpoint.
+
+- **Port:** `8811`
+- **Static IP:** `10.2.0.35` (Unraid `br0`)
+- **Registry:** `git.alwisp.com/jason/totalmcp`
+- **Spec:** see [`PLAN.md`](PLAN.md) for the full architecture and phased roadmap
+- **Service inventory:** see [`SERVICES.md`](SERVICES.md) for the catalog this gateway plugs into
+
+## Quick Start (local dev)
+
+```bash
+cp .env.example .env       # then fill in tokens
+npm install
+npm run prisma:generate
+npm run dev                # starts tsx watch on src/server.ts
+```
+
+Verify:
+
+```bash
+curl http://localhost:8811/health
+# → { "status": "ok", "version": "0.1.0", "plugins": 0, "enabled": [] }
+```
+
+## Build & run
+
+```bash
+npm run build              # tsc → dist/
+npm start                  # node dist/server.js
+```
+
+## Docker (local dev)
+
+```bash
+docker compose up --build -d
+docker compose logs -f totalmcp
+```
+
+## Unraid deployment
+
+Step-by-step GUI walkthrough — paths, variables, ports, network — lives in [`INSTALL-UNRAID.md`](INSTALL-UNRAID.md). Covers the full deploy at `10.2.0.35:8811` plus a minimal "Gitea-plugin-only" starter config.
+
+## Endpoints
+
+| Method | Path        | Auth     | Purpose                              |
+|--------|-------------|----------|--------------------------------------|
+| GET    | `/health`   | none     | Liveness — used by Unraid HEALTHCHECK |
+| GET    | `/plugins`  | bearer   | Loaded plugin list + tool counts      |
+| POST   | `/mcp`      | bearer   | Streamable HTTP — primary MCP transport |
+| GET    | `/mcp`      | bearer   | Streamable HTTP server-sent stream    |
+
+…(truncated — see repo)
+
+## Notes
+
+- Project file auto-created from repo documentation.