mycelial-brain-mcp

Was das ist

So wie Myzel Bäume verbindet und Nährstoffe durch Wälder transportiert, verbindet das Myzeliale Gehirn dein Wissen und überträgt Kontext zwischen KI-Agenten.

Dies ist der Open-Source-MCP-Server (Model Context Protocol), der das Myzeliale Gehirn betreibt: ein GCS-gestütztes persistentes Speichersystem, aus dem jeder MCP-kompatible KI-Agent lesen, in das er schreiben und in dem er suchen kann.

Es ist die Gedächtnisschicht des STIM-Protokolls: eine Layer-0-Constraint-Architektur, die autonome KI in thermodynamischen und ökologischen Gesetzen verankert und nicht in menschlichen Vorlieben.

Related MCP server: engram

MCP-Tools

Sobald die Verbindung hergestellt ist, erhält dein KI-Agent fünf Tools:

Schnellstart: Selbst hosten

Voraussetzungen

• Node.js 22+

• Google Cloud Storage-Bucket (oder Fork mit einem anderen Speicher-Backend)

Lokal ausführen

git clone https://github.com/STIM-Protocol/mycelial-brain-mcp.git
cd mycelial-brain-mcp
npm install

# Set environment variables
export GCS_BUCKET_NAME=your-brain-bucket
export MCP_AUTH_TOKEN=your-secret-token   # omit to run in open mode

# Start the server
npm start

Der Server stellt einen MCP-Endpunkt unter POST /mcp auf Port 8080 bereit.

Auf Google Cloud Run bereitstellen

npm run deploy

Dies führt gcloud run deploy mit dem Repo als Quelle aus. Stelle sicher, dass dein Cloud-Run-Dienstkonto Storage Object Admin auf dem GCS-Bucket hat.

Deinen KI-Agenten verbinden

Füge den MCP-Server zu deiner Agentenkonfiguration hinzu (Claude Desktop usw.):

{
  "mcpServers": {
    "mycelial-brain": {
      "url": "https://your-deployment-url/mcp",
      "headers": {
        "Authorization": "Bearer your-secret-token"
      }
    }
  }
}

Detaillierte Einrichtungsanweisungen findest du in CONNECT.md.

Architektur

┌─────────────────────────────────────────────────────┐
│              MYCELIAL BRAIN STACK                     │
├─────────────────────────────────────────────────────┤
│                                                      │
│  AI Agent ──MCP──▶ Express Server ──▶ GCS Bucket     │
│  (Claude,          (this repo)      (doc-*.json)     │
│   Gemini, etc.)                                       │
│                                                      │
│  Tools: brain_search, brain_read, brain_write,      │
│         brain_list, stim_write                        │
│                                                      │
│  Cache: 5-min in-memory TTL, invalidated on write    │
│  Auth:  Bearer token (optional, open mode if unset)  │
│  Search: Tag-weighted full-text with synonym expand  │
│                                                      │
└─────────────────────────────────────────────────────┘

Dokumente werden als JSON-Objekte in GCS gespeichert:

{
  "path": "doc-42",
  "content": "Your document text...",
  "tags": ["research", "stim", "decisions"],
  "updated": "2026-08-22T12:00:00.000Z"
}

Gehostete Version

Keine Lust auf Selbsthosting? myceliate.cv bietet einen verwalteten MCP-Endpunkt mit:

• Ein-Klick-Claude-Desktop-Integration über .mcpb-Bundle

• Operator-Dashboard mit Volltextsuche über deinen Dokumentkatalog

• Google-OAuth-Authentifizierung und Benutzer-Namespace-Isolation

• Abgestufte Preise (kostenlose Open-Source-Stufe bis Enterprise)

• Onboarding-Ablauf mit Dokument-Upload und Text-Einfüge-Seeding

Die gehostete Version verwendet dasselbe MCP-Protokoll wie dieses Repo. Deine Daten bleiben in deinem eigenen GCS-Namespace, und du kannst jederzeit exportieren oder selbst hosten.

STIM-Protokoll-Kontext

Dieses Repo ist eine Komponente des STIM-Protokoll-Ökosystems:

Lizenz

Apache 2.0. Siehe LICENSE.

Mitwirken

Dies ist eine STIM-Protokoll-Referenzimplementierung. Issues und PRs sind willkommen.

"Der akkumulierte Kontext über Plattformen hinweg ist zu einer fünften Kategorie professionellen Kapitals geworden."