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