MCP 服务器

mycelial-brain-mcp

Enables AI agents to read, write, search, and manage persistent, decentralized context memory via a GCS-backed MCP server, with tools for document storage, retrieval, and STIM protocol nuggets.

README

<h1 align="center">mycelial-brain-mcp</h1>

Persistent, decentralized context memory for AI agents STIM Protocol Reference Implementation: Mycelial Memory Layer

What This Is

Just as mycelium connects trees and transfers nutrients across forests, Mycelial Brain connects your knowledge and transfers context across AI agents.

This is the open-source MCP (Model Context Protocol) server that powers the Mycelial Brain: a GCS-backed persistent memory system that any MCP-compatible AI agent can read from, write to, and search.

It is the memory layer of the STIM Protocol: a Layer 0 constraint architecture that grounds autonomous AI in thermodynamic and ecological law rather than human preference.

MCP Tools

Once connected, your AI agent gets five tools:

Tool	Description
`brain_search`	Full-text keyword search across all brain documents with tag-weighted scoring
`brain_read`	Read a specific document by path (e.g., `doc-42`)
`brain_write`	Write a new document with auto-incremented ID or custom path
`brain_list`	List all documents with their tags
`stim_write`	Write a STIM protocol nugget with namespace and author metadata

Quick Start: Self-Host

Prerequisites

Node.js 22+
Google Cloud Storage bucket (or fork with a different storage backend)

Run Locally

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

The server exposes an MCP endpoint at POST /mcp on port 8080.

Deploy to Google Cloud Run

npm run deploy

This runs gcloud run deploy with the repo as source. Make sure your Cloud Run service account has Storage Object Admin on the GCS bucket.

Connect Your AI Agent

Add the MCP server to your agent configuration (Claude Desktop, etc.):

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

See CONNECT.md for detailed setup instructions.

Architecture

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

Documents are stored as JSON objects in GCS:

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

Hosted Version

Don't want to self-host? myceliate.cv offers a managed MCP endpoint with:

One-click Claude Desktop integration via .mcpb bundle
Operator dashboard with full-text search across your document catalog
Google OAuth authentication and per-user namespace isolation
Tiered pricing (free open-source tier through enterprise)
Onboarding flow with document upload and text paste seeding

The hosted version runs the same MCP protocol as this repo. Your data stays in your own GCS namespace, and you can export or self-host at any time.

STIM Protocol Context

This repo is one component of the STIM Protocol ecosystem:

Repo	Role
stim-core	Layer 0 specification: nature-grounded intelligence constraints
white-paper	Versioned, arXiv-ready documentation
stim-guard	pip-installable constraint engine for AI agents
gpd-framework	Physics-based dimensional analysis and thermodynamic convergence
Forest_OS	Knowledge organism: living, self-governing file system
mycelial-brain-mcp	MCP memory layer (this repo)