Skip to main content
Glama
STIM-Protocol

mycelial-brain-mcp


これは何か

菌糸が樹木同士を結び、森全体に栄養を運ぶように、Mycelial Brain はあなたの知識を結びつけ、AI エージェント間でコンテキストを運びます。

これは Mycelial Brain を支えるオープンソースの MCP (Model Context Protocol) サーバーです。GCS をバックエンドとする永続メモリシステムで、MCP 互換の AI エージェントなら誰でも読み書きや検索ができます。

これは STIM Protocol のメモリレイヤーです。STIM Protocol は、自律型 AI を人間の好みではなく熱力学と生態学の法則に基づかせる Layer 0 制約アーキテクチャです。

Related MCP server: engram

MCP ツール

接続すると、AI エージェントは次の 5 つのツールを利用できます:

ツール

説明

brain_search

タグ重み付けスコアリングによる全ブレインドキュメントの全文キーワード検索

brain_read

パスを指定して特定のドキュメントを読む(例: doc-42)

brain_write

自動インクリメント ID またはカスタムパスで新しいドキュメントを書く

brain_list

タグ付きの全ドキュメントを一覧表示

stim_write

名前空間と著者メタデータ付きの STIM protocol ナゲットを書く

クイックスタート: セルフホスト

前提条件

  • 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 の POST /mcp で 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  │
│                                                      │
└─────────────────────────────────────────────────────┘

ドキュメントは GCS に JSON オブジェクトとして保存されます:

{
  "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 Protocol のコンテキスト

このリポジトリは STIM Protocol エコシステムの 1 コンポーネントです:

リポジトリ

役割

stim-core

Layer 0 仕様: 自然に根ざした知能の制約

white-paper

バージョン管理された arXiv 対応ドキュメント

stim-guard

AI エージェント向け pip インストール可能な制約エンジン

gpd-framework

物理学に基づく次元解析と熱力学的収束

Forest_OS

知識オーガニズム: 生きた自己統治型ファイルシステム

mycelial-brain-mcp

MCP メモリレイヤー(このリポジトリ)

ライセンス

Apache 2.0。LICENSE を参照してください。

コントリビューション

これは STIM Protocol の参照実装です。Issue と PR を歓迎します。


"プラットフォームを超えて蓄積されたコンテキストは、プロフェッショナル資本の第 5 のカテゴリーとなった。"

Maintenance

ActivityMaintained
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
    786 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.
    4 npm
    MIT