ZimaTools

Application native ZimaOS : serveur MCP (HTTP), interface web et arbitre GPU pour une VRAM exclusive.

Popcorn a priorite sur Ollama et les agents. Un seul lease GPU a la fois.

Repo : https://github.com/bobdivx/zimatools
Origine : zimaos-cursor-mcp v0.0.2 (historique conserve).

Stack

• Monorepo pnpm workspaces

• apps/mcp — TypeScript, mcp-framework 0.2.x, transport HTTP Stream (/mcp) + stdio optionnel

• Pont REST Hono (/api/*) pour l'UI

• apps/web — Astro + Preact + Tailwind CSS + DaisyUI

• docker-compose.yml pret pour ZimaOS (docker.sock, NVIDIA optionnel)

Related MCP server: AX Local Operations MCP Server

Architecture

zimatools/
  apps/mcp/     serveur MCP + REST + arbitre GPU
  apps/web/     UI Astro/Preact/DaisyUI
  docker/       Dockerfiles
  docker-compose.yml
  docker-compose.gpu.yml

Installation locale (dev)

Prerequis : Node.js 20+, pnpm 10 (corepack enable).

git clone https://github.com/bobdivx/zimatools.git
cd zimatools
cp .env.example .env
# renseigner ZIMAOS_API_BASE / ZIMAOS_API_TOKEN / SSH si besoin
pnpm install
pnpm --filter @zimatools/mcp build

Deux terminaux :

pnpm dev:mcp    # MCP HTTP :8765 + REST :8766
pnpm dev:web    # UI :4321 (proxy /api -> 8766)

Stdio (Cursor local uniquement) :

pnpm --filter @zimatools/mcp dev:stdio

Installation sur ZimaOS

Pas de deploiement automatique dans cette version. Compose pret a copier :

1. Cloner (ou copier) le depot sur le NAS.

2. cp .env.example .env et renseigner les tokens.

3. Sans GPU :

docker compose up -d --build

4. Avec NVIDIA (nvidia-container-toolkit) :

docker compose -f docker-compose.yml -f docker-compose.gpu.yml up -d --build

• UI : http://<nas>:8080

• MCP : http://<nas>:8765/mcp

• REST : http://<nas>:8766/health

Le socket Docker est monte (/var/run/docker.sock). Le runtime NVIDIA est optionnel.

Endpoint MCP (HTTP)

Transport : Streamable HTTP (mcp-framework http-stream), pas seulement stdio.

• URL : http://<nas-ou-localhost>:8765/mcp

• Methodes : POST / GET / DELETE / OPTIONS

• CORS ouvert par defaut (MCP_CORS_ORIGIN=*, MCP_HOST=0.0.0.0)

Exemple Cursor / DevForge (mcp.json) :

{
  "mcpServers": {
    "zimatools": {
      "url": "http://zimacube.local:8765/mcp"
    }
  }
}

Stdio local (sans NAS) :

{
  "mcpServers": {
    "zimatools": {
      "command": "node",
      "args": ["<chemin>/apps/mcp/dist/index.js", "--stdio"],
      "env": {
        "ZIMAOS_API_BASE": "http://zimacube.local",
        "ZIMAOS_API_TOKEN": "..."
      }
    }
  }
}

REST UI (Hono, memes outils GPU) :

• GET /health

• GET /api/gpu/status

• POST /api/gpu/acquire { "client": "popcorn" }

• POST /api/gpu/release { "client": "popcorn" }

• GET /api/gpu/queue

• POST /api/gpu/priority { "client": "ollama", "priority": 50 }

• GET /api/docker/containers

Outils MCP

Fichiers ZimaOS (existants, via API)

read_file_from_zimaos, list / write / edit / search / mkdir / stats — voir apps/mcp/src/tools/.

Docker (existants, via SSH)

list_docker_containers_zimaos, start / stop / restart / logs / info.

GPU (v0 — file en memoire + nvidia-smi)

Modele : un seul holder. Popcorn vole le GPU a Ollama / agents ; le detenteur precedent est refile.

Stub / limites v0

• Queue et priorites en memoire (perdues au restart).

• nvidia-smi parse CSV ; sinon GPU factice stub-gpu.

• Pas encore d'arret/redemarrage reel d'Ollama ou de containers GPU.

• Liste Docker UI : SSH si configure, sinon placeholder.

Variables d'environnement

Voir .env.example.

Developpement

pnpm build          # mcp + web
pnpm --filter @zimatools/web build

L'integration Home Assistant historique est dans legacy/ha/.

Licence

A definir. Issues : https://github.com/bobdivx/zimatools/issues