Skip to main content
Glama
tomoharu-hayashi

MCP Brain Server

by tomoharu-hayashi
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

MCP Brain Server

AIエージェントに「統合的な知識」を提供するMCPサーバー

コンセプト

人間が仕事を覚えるように、AIも知識を学習する

人間が仕事を習得するプロセス:

  1. 観察: 先輩のやり方を見る

  2. 実践: 自分でやってみる

  3. 失敗: うまくいかない

  4. 修正: フィードバックを受けて調整

  5. 定着: 繰り返して身につく

このサーバーは、AIエージェントに同様の学習サイクルを提供する。

機能

知識の参照

  • タスクに関連する知識を検索

  • 知識の詳細を取得

知識の学習

  • 実行結果の記録（成功/失敗）

  • 失敗からの改善点を知識に反映

  • 新しい知識の自動生成

将来実装

  • 自動削除（忘却）: 使用頻度の低い知識を自動でアーカイブ・削除

知識の構造

mcp-brain-storage/          # Gitリポジトリ（Obsidianで開ける）
├── .index_cache.pkl        # キャッシュ
├── .index_hash
├── README.md
└── knowledge/              # 知識ファイルはここに配置
    ├── create-pr.md        # フラット形式（Obsidian互換）
    ├── deploy-staging.md
    └── git-commit.md
---
name: create-pr
description: PRを作成したいとき
version: 1
created: 2025-12-01
---
PRを作成する方法。

1. 変更をコミット
2. gh pr create --fill
3. レビュアーをアサイン

Tools

Tool

説明

search

タスクに関連する知識を検索

get

知識の詳細を取得（関連知識も自動展開）

create

新しい知識を作成

update

既存の知識を更新

関連知識の自動連想

get で知識を取得すると、Embeddingベースの類似度で関連する知識が自動的に展開されます。 手動でリンクを張る必要はありません。脳のように、意味的に近い知識が自動で連想されます。

hops パラメータで連想の深さを指定可能（デフォルト: 2）。

# 2ホップ先まで関連知識を取得
get(name="create-pr", hops=2)
{
  "name": "create-pr",
  "description": "PRを作成したいとき",
  "content": "## 手順...",
  "related": [
    {
      "name": "git-commit",
      "description": "変更をコミットしたいとき",
      "related": [
        {"name": "git-push", "description": "リモートにプッシュしたいとき", "related": []}
      ]
    }
  ]
}

Git連携

自動バージョン管理

知識の作成・更新・削除は自動的にGitにコミットされます。

# 知識ディレクトリをGitリポジトリとして初期化
cd ~/.mcp-brain
git init
git remote add origin git@github.com:your-name/mcp-brain-knowledge.git

# 以降、知識の変更は自動でコミット・プッシュされる

コミットメッセージ

操作に応じて自動生成されます:

  • create: {knowledge-name} - 新しい知識を作成

  • update: {knowledge-name} - 既存の知識を更新

  • forget: {knowledge-name} - 知識を削除

メリット

  • 📝 履歴管理: 知識の変更履歴を追跡

  • 🔄 同期: 複数デバイス間で知識を同期

  • 👥 共有: チームで知識を共有

  • 🔙 復元: 削除した知識を復元可能

インストール

uv tool install . --force

開発コマンド

make help
make doctor
make deps
make lint
make fmt
make test
make dev ARGS="--help"

設定

共通知識（全プロジェクトで共有）

{
  "mcpServers": {
    "brain": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/tomoharu-hayashi/mcp-server-brain.git", "mcp-brain"],
      "env": {
        "MCP_BRAIN_DIR": "~/pj/my/mcp-brain-storage"
      }
    }
  }
}

プロジェクト独立の知識

プロジェクトごとに完全に独立した知識空間を持たせる場合。

1. プロジェクト内に知識ディレクトリを作成

cd /path/to/your-project
mkdir .brain
cd .brain
git init
git remote add origin git@github.com:your-name/your-project-brain.git

2. MCP設定（プロジェクトごと）

VS Code / Cursor の場合、.vscode/mcp.json を作成:

{
  "mcpServers": {
    "brain": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/tomoharu-hayashi/mcp-server-brain.git", "mcp-brain"],
      "env": {
        "MCP_BRAIN_DIR": "${workspaceFolder}/.brain"
      }
    }
  }
}

3. .gitignore に追加

親リポジトリで .brain/ が検知されないように:

.brain/

構成パターン

パターン

MCP_BRAIN_DIR

用途

共通

~/pj/my/mcp-brain-storage

汎用ワークフロー（Git、PR作成など）

プロジェクト独立

${workspaceFolder}/.brain

プロジェクト固有の知識

チーム共有

リポジトリ内 .brain/

チームで知識を共有

This server cannot be installed

F
license - not found
-
quality - not tested
-
maintenance - not tested

How are these scores calculated?

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/tomoharu-hayashi/mcp-server-brain'

If you have feedback or need assistance with the MCP directory API, please join our Discord server