Skip to main content
Glama

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/

チームで知識を共有

-
security - not tested
F
license - not found
-
quality - not tested

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