goldbrain/.source-references/references-only/reference vault/memory/projects/totalmcp.md

type, status, source, repo, repo_url, language, branch, tags, updated

type	status	source	repo	repo_url	language	branch	tags	updated
project	active	git.alwisp.com	jason/totalmcp	https://git.alwisp.com/jason/totalmcp	TypeScript	main	repo jason mcp ai	2026-05-29

totalmcp

Repository: 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 for the full architecture and phased roadmap
• Service inventory: see SERVICES.md for the catalog this gateway plugs into

Quick Start (local dev)

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:

curl http://localhost:8811/health
# → { "status": "ok", "version": "0.1.0", "plugins": 0, "enabled": [] }

Build & run

npm run build              # tsc → dist/
npm start                  # node dist/server.js

Docker (local dev)

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