mycelial-brain-mcp

Что это такое

Подобно тому, как мицелий соединяет деревья и переносит питательные вещества по лесу, Mycelial Brain соединяет ваши знания и переносит контекст между ИИ-агентами.

Это open-source MCP-сервер (Model Context Protocol), который обеспечивает работу Mycelial Brain: системы постоянной памяти на базе GCS, которую любой MCP-совместимый ИИ-агент может читать, записывать и искать.

Это слой памяти STIM Protocol: архитектура ограничений Layer 0, которая укореняет автономный ИИ в термодинамических и экологических законах, а не в человеческих предпочтениях.

Related MCP server: engram

Инструменты MCP

После подключения ваш ИИ-агент получает пять инструментов:

Быстрый старт: самостоятельное развёртывание

Предварительные требования

• 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

Сервер предоставляет MCP-эндпоинт по адресу POST /mcp на порту 8080.

Развёртывание в Google Cloud Run

npm run deploy

Это запускает gcloud run deploy с репозиторием в качестве источника. Убедитесь, что сервисный аккаунт Cloud Run имеет роль Storage Object Admin для бакета GCS.

Подключение вашего ИИ-агента

Добавьте 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-эндпоинт с:

• Интеграция с Claude Desktop в один клик через .mcpb-пакет

• Панель оператора с полнотекстовым поиском по вашему каталогу документов

• Аутентификация через Google OAuth и изоляция пространств имён для каждого пользователя

• Многоуровневое ценообразование (от бесплатного open-source тарифа до корпоративного)

• Процесс онбординга с загрузкой документов и заполнением через вставку текста

Управляемая версия работает по тому же MCP-протоколу, что и этот репозиторий. Ваши данные остаются в вашем собственном пространстве имён GCS, и вы можете в любой момент экспортировать их или развернуть собственную версию.

Контекст STIM Protocol

Этот репозиторий — один из компонентов экосистемы STIM Protocol:

Лицензия

Apache 2.0. См. LICENSE.

Участие в разработке

Это эталонная реализация STIM Protocol. Приветствуются issues и PR.

«Накопленный контекст на разных платформах стал пятой категорией профессионального капитала».