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 代理将获得五个工具:
工具 | 描述 |
| 对所有脑文档进行全文关键词搜索,并按标签加权评分 |
| 按路径读取特定文档(例如 |
| 写入新文档,使用自动递增 ID 或自定义路径 |
| 列出所有文档及其标签 |
| 写入带有命名空间和作者元数据的 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 协议生态系统的一个组件:
仓库 | 角色 |
Layer 0 规范:基于自然的智能约束 | |
版本化、arXiv 就绪的文档 | |
可通过 pip 安装的 AI 代理约束引擎 | |
基于物理的维度分析和热力学收敛 | |
知识有机体:活的、自治的文件系统 | |
mycelial-brain-mcp | MCP 记忆层(本仓库) |
许可证
Apache 2.0。请参阅 LICENSE。
贡献
这是 STIM Protocol 的参考实现。欢迎提交 Issue 和 PR。
"跨平台积累的上下文已成为第五类职业资本。"
This server cannot be deployed
Maintenance
Related MCP Connectors
Cross-tool persistent memory and context for AI assistants over MCP.
Persistent memory, knowledge graph, task management and more for AI agents via MCP.
Shared long-term memory vault for AI agents with 20 MCP tools.
Shared memory for your AI tools: tasks, notes and context every tool can read and write over MCP.
Related MCP Servers
- AlicenseAqualityDmaintenancePersistent memory for AI agents. Store, recall, and share knowledge across sessions with five MCP tools: remember, recall, context, forget, and share. Includes semantic search and agent/user/org scoping.53Apache 2.0
- AlicenseCqualityAmaintenanceProvides persistent, local-first AI memory across sessions via MCP tools for storing, searching, and retrieving context from past interactions.31139 PyPI1MIT
- AlicenseNot gradedqualityCmaintenanceProvides 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.33Apache 2.0
- AlicenseNot gradedqualityBmaintenanceEnables 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 npmMIT