Provides automatic version control for knowledge files, with auto-commit functionality for knowledge creation, updates, and deletion operations.
Enables synchronization and sharing of knowledge repositories across devices and teams through remote repository integration.
Stores knowledge in Obsidian-compatible format, allowing the knowledge directory to be opened and edited as an Obsidian vault.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Brain Serversearch for how to deploy to staging"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Brain Server
AIエージェントに「統合的な知識」を提供するMCPサーバー
コンセプト
人間が仕事を覚えるように、AIも知識を学習する
人間が仕事を習得するプロセス:
観察: 先輩のやり方を見る
実践: 自分でやってみる
失敗: うまくいかない
修正: フィードバックを受けて調整
定着: 繰り返して身につく
このサーバーは、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 | 説明 |
| タスクに関連する知識を検索 |
| 知識の詳細を取得（関連知識も自動展開） |
| 新しい知識を作成 |
| 既存の知識を更新 |
関連知識の自動連想
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.git2. 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 | 用途 |
共通 |
| 汎用ワークフロー（Git、PR作成など） |
プロジェクト独立 |
| プロジェクト固有の知識 |
チーム共有 | リポジトリ内 | チームで知識を共有 |
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.