89 lines
2.4 KiB
Markdown
89 lines
2.4 KiB
Markdown
---
|
|
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.
|