mycelial-brain-mcp

Qué es esto

Así como el micelio conecta árboles y transfiere nutrientes a través de los bosques, Mycelial Brain conecta tu conocimiento y transfiere contexto entre agentes de IA.

Este es el servidor MCP (Model Context Protocol) de código abierto que impulsa Mycelial Brain: un sistema de memoria persistente respaldado por GCS que cualquier agente de IA compatible con MCP puede leer, escribir y buscar.

Es la capa de memoria del protocolo STIM: una arquitectura de restricciones de capa 0 que fundamenta la IA autónoma en leyes termodinámicas y ecológicas, no en preferencias humanas.

Related MCP server: engram

Herramientas MCP

Una vez conectado, tu agente de IA obtiene cinco herramientas:

Inicio rápido: autoalojamiento

Requisitos previos

• Node.js 22+

• Bucket de Google Cloud Storage (o haz un fork con un backend de almacenamiento diferente)

Ejecutar localmente

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

El servidor expone un endpoint MCP en POST /mcp en el puerto 8080.

Desplegar en Google Cloud Run

npm run deploy

Esto ejecuta gcloud run deploy con el repositorio como fuente. Asegúrate de que la cuenta de servicio de Cloud Run tenga Storage Object Admin en el bucket de GCS.

Conecta tu agente de IA

Añade el servidor MCP a la configuración de tu agente (Claude Desktop, etc.):

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

Consulta CONNECT.md para obtener instrucciones detalladas de configuración.

Arquitectura

┌─────────────────────────────────────────────────────┐
│              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  │
│                                                      │
└─────────────────────────────────────────────────────┘

Los documentos se almacenan como objetos JSON en GCS:

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

Versión alojada

¿No quieres autoalojar? myceliate.cv ofrece un endpoint MCP gestionado con:

• Integración de Claude Desktop con un clic mediante el paquete .mcpb

• Panel de operador con búsqueda de texto completo en todo tu catálogo de documentos

• Autenticación con Google OAuth y aislamiento de espacio de nombres por usuario

• Precios escalonados (nivel gratuito de código abierto hasta empresarial)

• Flujo de incorporación con carga de documentos y siembra de texto pegado

La versión alojada ejecuta el mismo protocolo MCP que este repositorio. Tus datos permanecen en tu propio espacio de nombres de GCS, y puedes exportarlos o autoalojarlos en cualquier momento.

Contexto del protocolo STIM

Este repositorio es un componente del ecosistema del protocolo STIM:

Licencia

Apache 2.0. Consulta LICENSE.

Contribuciones

Esta es una implementación de referencia del protocolo STIM. Se aceptan issues y PRs.

"El contexto acumulado entre plataformas se ha convertido en una quinta categoría de capital profesional."