Skip to main content
Glama
STIM-Protocol

mycelial-brain-mcp


这是什么

正如菌丝连接树木并在森林中传递养分一样,Mycelial Brain 连接你的知识并在 AI 代理之间传递上下文。

这是为 Mycelial Brain 提供支持的开源 MCP(Model Context Protocol)服务器:一个基于 GCS 的持久化记忆系统,任何兼容 MCP 的 AI 代理都可以读取、写入和搜索。

它是 STIM Protocol 的记忆层:一种 Layer 0 约束架构,将自主 AI 建立在热力学和生态法则之上,而非人类偏好。

Related MCP server: engram

MCP 工具

连接后,你的 AI 代理将获得五个工具:

工具

描述

brain_search

对所有脑文档进行全文关键词搜索,并按标签加权评分

brain_read

按路径读取特定文档(例如 doc-42)

brain_write

写入新文档,使用自动递增 ID 或自定义路径

brain_list

列出所有文档及其标签

stim_write

写入带有命名空间和作者元数据的 STIM 协议片段

快速开始:自托管

先决条件

  • Node.js 22+

  • Google Cloud Storage 存储桶(或使用不同存储后端的分支)

本地运行

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

服务器在 8080 端口暴露一个 MCP 端点:POST /mcp。

部署到 Google Cloud Run

npm run deploy

这会以仓库为源代码运行 gcloud run deploy。请确保你的 Cloud Run 服务账号对 GCS 存储桶具有 Storage Object Admin 权限。

连接你的 AI 代理

将 MCP 服务器添加到你的代理配置中(Claude Desktop 等):

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

有关详细的设置说明,请参阅 CONNECT.md。

架构

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

文档以 JSON 对象形式存储在 GCS 中:

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

托管版本

不想自托管?myceliate.cv 提供托管 MCP 端点,具有以下功能:

  • 通过 .mcpb 捆绑包一键集成 Claude Desktop

  • 操作员仪表板,支持对文档目录进行全文搜索

  • Google OAuth 身份验证和按用户命名空间隔离

  • 分层定价(从免费开源层到企业版)

  • 包含文档上传和文本粘贴播种的入门流程

托管版本运行与此仓库相同的 MCP 协议。你的数据保留在你自己的 GCS 命名空间中,并且你可以随时导出或自托管。

STIM 协议上下文

本仓库是 STIM 协议生态系统的一个组件:

仓库

角色

stim-core

Layer 0 规范:基于自然的智能约束

white-paper

版本化、arXiv 就绪的文档

stim-guard

可通过 pip 安装的 AI 代理约束引擎

gpd-framework

基于物理的维度分析和热力学收敛

Forest_OS

知识有机体:活的、自治的文件系统

mycelial-brain-mcp

MCP 记忆层(本仓库)

许可证

Apache 2.0。请参阅 LICENSE。

贡献

这是 STIM Protocol 的参考实现。欢迎提交 Issue 和 PR。


"跨平台积累的上下文已成为第五类职业资本。"

Maintenance

ActivitySlowing
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    C
    quality
    A
    maintenance
    Provides persistent, local-first AI memory across sessions via MCP tools for storing, searching, and retrieving context from past interactions.
    31
    139 PyPI
    1
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Provides AI agents with persistent knowledge storage, enabling them to store, search, and retrieve text, documents, and files using semantic and keyword search via MCP tools.
    33
    Apache 2.0
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to store and semantically retrieve durable memories across sessions via MCP or REST, with tools for remembering, recalling, asking, updating, and forgetting memories.
    13 npm
    MIT