Akasha Mcp Server について
Akasha MCP Serverは、セッションやエージェント間で共有できる永続メモリを提供します。コンテキストを保持・検索したいシステム向けで、階層化メモリと共有シグナルによる連携が特徴です。
主な機能
- 01永続的な共有メモリ
- 024層の認知メモリ
- 03メモリ横断検索と想起
- 04エージェント間のシグナル連携
- 05メモリの自動統合
活用シーン
- 01ユーザーの好みやプロジェクト情報の保存
- 02API設計やデプロイ記録の検索
- 03他のエージェントの作業状況の確認
MCP 対応
MCP サーバーとして、メモリの読み書き・検索ツール、読み取り専用リソース、プロンプトテンプレートをクライアントに公開します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ツール一覧はまだ取得されていません
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
問題点
Claude、Gemini、GPT と新しい会話を始めるたびに:
- ❌ 昨日学んだことを覚えていません
- ❌ 複数のエージェントで知識を共有できません
- ❌ セッションをまたいでメモリを保持できません
- ❌ 同じコンテキストを何度も繰り返し伝える必要があります
解決策
Akasha は、AI に永続的な共有メモリを提供します。リセットされない脳を与えるようなものです。
Claude ──┐ ┌── "What did we decide about the API?"
Gemini ──┼── Akasha Memory ──┤── "Agent-B is already working on that"
GPT ─────┘ └── "Here's what we learned last week"
Akasha で AI にできること
| ツール | 機能 | 例 |
|---|---|---|
akasha_write | あらゆる情報を永続メモリに保存 | 「ユーザーは JS より Python を好むことを覚えておいて」 |
akasha_read | 保存したメモリを呼び出す | 「API 設計について何がわかっていますか?」 |
akasha_query | すべてのメモリを横断して検索 | 「デプロイに関連するすべての情報を探して」 |
akasha_memory_store | 認知レイヤー(作業/エピソード/意味/手続き)に書き込む | 「これを長期的な事実として保存して」 |
akasha_memory_recall | 特定のレイヤーからメモリを呼び出す | 「デプロイの手順には何がありますか?」 |
akasha_pheromone_emit | 他のエージェントにシグナルを送る(スティグマジー) | 「このタスクを進行中としてマークして」 |
akasha_pheromone_sense | 他のエージェントの作業状況を感知する | 「API に取り組んでいる人はほかにいますか?」 |
akasha_health | システムのステータスを確認 | 「メモリシステムは正常ですか?」 |
akasha_diagnostics | クラスター全体の健全性を評価 | 「診断レポートをすべて実行して」 |
akasha_agents | 接続中のエージェントをすべて一覧表示 | 「ほかに誰がオンラインですか?」 |
クイックセットアップ(2 分)
1. Akasha を起動する
docker run -d --name akasha -p 7777:7777 -p 50051:50051 alejandrosl/akasha:latest
2. API キーを取得する
# Login
TOKEN=$(curl -sk -X POST https://localhost:7777/api/v1/auth/login \
-H 'Content-Type: application/json' \
-d '{"username":"akasha","password":"akasha"}' | jq -r .token)
# Create API key
curl -sk -X POST https://localhost:7777/api/v1/admin/keys \
-H "Authorization: Bearer $TOKEN" \
-H 'Content-Type: application/json' \
-d '{"name":"mcp-server","namespaces":["**"],"role":"agent"}' | jq .key
3. AI に接続する
Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json に追加します:
{
"mcpServers": {
"akasha": {
"command": "uvx",
"args": ["--from", "git+https://github.com/ocuil/akasha-public#subdirectory=mcp-server", "akasha-mcp"],
"env": {
"AKASHA_URL": "https://localhost:7777",
"AKASHA_API_KEY": "ak_your_key_here"
}
}
}
}
Cursor
.cursor/mcp.json に追加します:
{
"mcpServers": {
"akasha": {
"command": "uvx",
"args": ["--from", "git+https://github.com/ocuil/akasha-public#subdirectory=mcp-server", "akasha-mcp"],
"env": {
"AKASHA_URL": "https://localhost:7777",
"AKASHA_API_KEY": "ak_your_key_here"
}
}
}
}
手動(pip install)
pip install git+https://github.com/ocuil/akasha-public#subdirectory=mcp-server
# Run
AKASHA_URL=https://localhost:7777 \
AKASHA_API_KEY=ak_your_key_here \
akasha-mcp
Akasha の特長
🐜 スティグマジー — 会話せずにエージェントが連携
設計図なしで複雑な構造を作るアリのコロニーから着想を得ています:
Agent A writes: "task/enrichment → SUCCESS (quality: 0.95)"
Agent B reads: "Someone already did enrichment with 95% quality — skip it"
Agent C reads: "Two successes on enrichment — this is a reliable path"
メッセージキューも、エージェント間の API もありません。環境に共有の痕跡を残すだけです。
🧠 4 つのメモリレイヤー
| レイヤー | 目的 | 寿命 |
|---|---|---|
| 作業 | 現在のタスクの一時メモ | 数分 |
| エピソード | 起きたこと — イベント、結果 | 数時間 → 数日 |
| 意味 | わかっていること — 事実、パターン | 数日 → 永続 |
| 手続き | 作業の進め方 — ワークフロー | 永続 |
🧘 Nidra — メモリを自動で統合
人間の睡眠のように、Akasha のバックグラウンドエンジンは次の処理を行います:
- 古くなった作業メモリを整理します
- 繰り返し現れるパターンを長期的な知識に統合します
- 劣化したシグナルを自動的に消去します
リソースとプロンプト
リソース(読み取り専用コンテキスト)
| URI | 説明 |
|---|---|
akasha://health | クラスターの健全性ステータス |
akasha://memory/layers | メモリレイヤーの分布 |
akasha://records/{path} | パスを指定して任意のレコードを読み取る |
akasha://agents/{agent_id} | エージェントの状態 |
akasha://tree | すべてのパスのツリー全体 |
akasha://diagnostics | クラスター診断レポート |
プロンプトテンプレート
| プロンプト | 内容 |
|---|---|
memory_consolidation | エピソード記憶を分析し、統合して意味知識にします |
agent_status_report | システム全体のエージェントとクラスターのステータスを表示します |
system_health_check | クラスターの詳細な健全性診断を行います |
knowledge_extraction | あらゆるトピックに関する知識を抽出して整理します |
設定
| 変数 | デフォルト値 | 説明 |
|---|---|---|
AKASHA_URL | https://localhost:7777 | Akasha サーバーのエンドポイント |
AKASHA_API_KEY | (required) | 認証用 API キー |
AKASHA_VERIFY_SSL | false | TLS 証明書を検証します |
開発
# Clone
git clone https://github.com/ocuil/akasha-public
cd akasha-public/mcp-server
# Install in dev mode
pip install -e .
# Interactive MCP inspector
fastmcp dev server.py
# Run with SSE transport
python server.py --transport sse --port 8765
詳細情報
コメント
Markdown 対応
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。