Omnispindle

Ein Todo-System, das wunderbar und absichtlich schiefgelaufen ist.

Omnispindle ist das Koordinationsrückgrat des Madness Interactive-Ökosystems — ein Python FastMCP-Server mit 32 Tools, der es KI-Agenten ermöglicht, Aufgaben zu verwalten, Wissen zu erfassen, Sitzungen zu koordinieren und durch die gesamte Werkstatt über eine einzige, standardisierte Schnittstelle zu navigieren. Als PyPI-Paket verfügbar. Auth0-integriert. Läuft überall dort, wo eine Claude Desktop-Konfiguration existiert.

Es begann mit dem Gedanken: „Lass uns Todos richtig machen.“ Es wurde zum zentralen Nervensystem für ein KI-gestütztes Entwicklungslabor mit mehreren Projekten. Beides ist völlig in Ordnung.

Was es tatsächlich tut

Todo-Verwaltung — der langweilige Teil, der alles andere ermöglicht. Agenten können Aufgaben über jedes Projekt im Ökosystem hinweg erstellen, abfragen, aktualisieren, abschließen und prüfen – mit vollständigen Metadaten, Prioritäten, Verfolgung der Ziel-Agenten und Änderungserkennung.

Wissenserfassung — gewonnene Erkenntnisse werden mit Sprach-, Themen- und Tag-Metadaten gespeichert. Durchsuchbar per Regex, Text oder Vektor-Embedding. Das institutionelle Gedächtnis verflüchtigt sich nicht, wenn das Gespräch endet.

Sitzungsverfolgung — KI-Arbeitssitzungen im Inventorium können geforkt, erstellt, mit Todos verknüpft und durch einen vollständigen Genealogie-Baum nachverfolgt werden. Jeder Arbeitsstrang hat einen Ursprung und eine Abstammung.

Semantische Suche — find_relevant nutzt Vektor-Embeddings, um Todos und Lektionen nach Bedeutung zu finden, nicht nur nach Schlüsselwörtern. get_context_bundle liefert einem Agenten das vollständige Projektbild in einem einzigen Aufruf.

Bring your own tool — injiziere Python-, JavaScript- oder Shell-Code zur Laufzeit als Live-MCP-Tool. Kein Neustart erforderlich. Wir haben das gemacht, weil wir es brauchten.

Related MCP server: Coding Todo Server

Installation

pip install omnispindle

Nach der Installation verfügbare CLI-Befehle:

• omnispindle-stdio — MCP stdio-Server für Claude Desktop

• omnispindle / omnispindle-server — HTTP-Webserver für authentifizierte Endpunkte

Claude Desktop (keine Konfiguration)

Füge dies zur claude_desktop_config.json hinzu:

{
 "mcpServers": {
 "omnispindle": {
 "command": "omnispindle-stdio",
 "env": {
 "OMNISPINDLE_MODE": "api",
 "OMNISPINDLE_TOOL_LOADOUT": "basic",
 "MCP_USER_EMAIL": "you@example.com"
 }
 }
 }
}

Der erste Tool-Aufruf öffnet deinen Browser für den Auth0-Login. Das Token wird lokal gespeichert. Das ist alles.

Entwicklung

git clone https://github.com/DanEdens/Omnispindle.git
cd Omnispindle
pip install -r requirements.txt
python -m src.Omnispindle.stdio_server

Tools

Das vollständige Set umfasst 32 Tools in 6 Kategorien. Steuere, was verfügbar ist – und das Token-Budget deines Agenten – mit OMNISPINDLE_TOOL_LOADOUT.

Todo-Verwaltung (9 Tools)

Wissen / Lektionen (7 Tools)

Inventorium-Sitzungen (8 Tools)

Kontext & Suche (2 Tools)

System / Admin (5 Tools)

Benutzerdefinierter Code (1 Tool)

Tool-Loadouts

Setze OMNISPINDLE_TOOL_LOADOUT, um zu steuern, was registriert wird:

Betriebsmodi

Einstellung über OMNISPINDLE_MODE:

• api — HTTP-Aufrufe an madnessinteractive.cc/api. Keine lokale Datenbank erforderlich. Am besten für Cloud-native oder Multi-User-Setups.

• hybrid (Standard) — API-First mit MongoDB-Fallback. Zuverlässig, wenn das Netzwerk es nicht ist.

• local — Nur direkte MongoDB-Verbindungen. Gut für Offline-Entwicklung.

• auto — Benchmarkt beides und wählt das schnellere.

Authentifizierung

Zero-Config Device Flow: Beim ersten Tool-Aufruf öffnet sich ein Browserfenster für den Auth0-Login. Das Token wird lokal gespeichert. Alle nachfolgenden Aufrufe sind ohne weitere Konfiguration authentifiziert.

Manuelle Token-Einrichtung (optional):

python -m src.Omnispindle.token_exchange

Umgebungsvariablen:

• MADNESS_AUTH_TOKEN oder AUTH0_TOKEN — JWT vom Auth0 Device Flow

• MCP_USER_EMAIL — erforderlich für benutzerbezogene Datenisolierung

• MADNESS_API_URL — Überschreiben der API-Basis (Standard: https://madnessinteractive.cc/api)

Alle Daten sind auf Datenbankebene pro Benutzer isoliert. Deine Todos bleiben deine.

Konfiguration

# Operation mode
OMNISPINDLE_MODE=hybrid # api | hybrid | local | auto
OMNISPINDLE_TOOL_LOADOUT=basic # see loadouts table above
OMNISPINDLE_FALLBACK_ENABLED=true

# Authentication
MADNESS_AUTH_TOKEN=<jwt>
MCP_USER_EMAIL=you@example.com

# Local/hybrid database
MONGODB_URI=mongodb://localhost:27017
MONGODB_DB=swarmonomicon

# Real-time events
MQTT_HOST=localhost
MQTT_PORT=1883

Ökosystem

Omnispindle ist die KI-Schnittstellenschicht. Der Rest der Werkstatt:

Inventorium — React-Web-Dashboard und SwarmDesk 3D-Raumarbeitsbereich. Menschen nutzen dies. Es liest Todos und Sitzungen direkt über die REST-API – nicht MCP, das ausschließlich für KI-Agenten gedacht ist. Wenn du auf Schaltflächen klickst, bist du im Inventorium. Wenn du ein Agent bist, rufst du MCP-Tools auf.

cartogomancy — JS/TS-Codebase-Analysetool (npm install -g @madnessengineering/cartogomancy). Zeige auf ein beliebiges JavaScript- oder TypeScript-Projekt; erhalte eine reichhaltige JSON-Karte der Struktur, Komplexität, Git-Blame und Querverweise. Füttere diese Karte in SwarmDesk und deine Codebase wird zu einer 3D-Stadt, durch die du laufen kannst.

SwarmDesk — Die 3D-Visualisierungsschicht innerhalb von Inventorium. Todos, Sitzungen und Cartogomancy-Code-Karten werden als erforschbare Architektur gerendert. Dein Projekt als Ort, nicht als Liste.

MadnessVR — Quest 2 VR-Version von SwarmDesk. Setz das Headset auf, laufe durch deine Codebase als tatsächliche Geometrie. Dies steht auf der Roadmap, nicht in den Release-Notes. Aber der Plan existiert und ist detailliert.

Cogwyrm — KI-Chat-Begleiter, der in das Ökosystem integriert ist. Nutzt während der Gespräche Omnispindle MCP-Tools, um geteilten Kontext zu lesen und zu schreiben.

Swarmonomicon — Die Kern-Datenbankschicht. MongoDB, swarmonomicon-Datenbank. Alles Persistente lebt hier.

Die Architekturregel

UI (Inventorium, forms, dashboards) → REST API → Database
AI agents (Claude, Cogwyrm, any MCP client) → MCP tools → Backend → Database

Route niemals UI durch MCP. Rufe niemals die REST-API direkt von einem KI-Agenten aus auf. Die Trennung ist beabsichtigt und tragend.

Entwicklung

# Tests
pytest tests/

# Stdio server (Claude Desktop)
python -m src.Omnispindle.stdio_server

# Web server
python -m src.Omnispindle

# Check tool count
python -c "from src.Omnispindle.tool_loadouts import _BASE_LOADOUTS; print(len(_BASE_LOADOUTS['full']), 'tools in full loadout')"

PyPI-Veröffentlichung

# Build and check
python -m build
python -m twine check dist/*

# Publish
python -m twine upload dist/*

Datenschutz & Sicherheit

Dieses Repo enthält Auth0-Konfigurationen und Infrastructure-as-Code für unser Ökosystem. Es ist Open Source zum Lernen und Forken – nicht zum direkten Einsatz.

Wenn du dies tatsächlich für dein eigenes Setup betreibst:

1. Forke es

2. Ersetze alle Auth-Provider und Anmeldedaten

3. Zeige auf deine eigene Domain und Datenbank

4. Überprüfe die Tool-Berechtigungen (wir sind standardmäßig freizügig)

Dies ist ein funktionierendes System für unser Labor. Für deines, mache es zu deinem.

Philosophie

Die meisten Leute bauen eine Todo-App mit 5 Funktionen. Wir haben eine mit 32 MCP-Tools, drei Betriebsmodi, Sitzungs-Genealogie-Bäumen, Vektor-Embeddings, Zero-Config OAuth und einer Roadmap gebaut, die das Durchlaufen deines Codes in VR beinhaltet.

Das ist das richtige Maß an Komplexität. Jedes Teil ist tragend.

Funktioniert jetzt:

• Todo-Verwaltung für KI-Agenten — robust, geprüft, benutzerbezogen

• Persistente Wissenserfassung über Projekte hinweg

• Sitzungsverfolgung mit vollständiger Abstammung

• Semantische Suche via Vektor-Embeddings

• Zero-Config Auth0, das keine Einrichtungsanleitung erfordert

Demnächst:

• MadnessVR: SwarmDesk auf Quest 2

• Vermittlung von Prompt-Engineering durch Inventar-Mechaniken im Terraria-Stil

• cartogomancy → SwarmDesk → VR als eine durchgehende Pipeline

Wir schreiben sorgfältigen Code. Wir haben keine Angst, die Grenzen zu verschieben, wenn es praktisch ist.

"Überentwickelt? Vielleicht. Unterambitioniert? Niemals."

Maintenance

Resources

• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers