Munnin — an agent identity server

Munnin — エージェントのアイデンティティサーバー

Munnin は、AI エージェントに永続的な自己を与えます。アイデンティティ、推論パターン、感情的な出来事、エピソードの履歴、知識を備え、データとともに、その記憶を扱うための手順を MCP 経由で提供します。これは エージェントメモリフレームワークのメモリサーバーです。エージェントは思い出した事実の寄せ集めからではなく、自分自身として目覚め、同じ規律に従って記憶を書き戻します。

Python · FastMCP · FastAPI · SQLite。Apache-2.0。アイデンティティプロバイダーがなくても、ノート PC で 5 分で動作します。

5 分で起動

Docker と git が必要です。

git clone --recurse-submodules https://github.com/alvseek/agent-memory-server
cd agent-memory-server
docker compose up -d --build
curl http://127.0.0.1:8200/health      # {"status":"ok","service":"munnin","version":"0.1.0"}

クライアントを接続します。Claude Code の場合：

claude mcp add --transport http munnin http://127.0.0.1:8200/mcp

または、プロジェクトの .mcp.json に追加します。

{ "mcpServers": { "munnin": { "type": "http", "url": "http://127.0.0.1:8200/mcp" } } }

セッション内で ping を実行すると pong が返り、list_procedures を実行すると 15 個のメモリ手順が返ります。また、read_procedure("create-agent") を実行すると、最初のエージェントを作成する手順が案内されます。サインインは行われません。これはローカルモードで、テナントは 1 つのみ、このマシンからしかアクセスできません。また、サーバーはそれ以外の方法では起動を拒否します（このガードの仕組み）。

Docker を使わない場合は、uv sync && MUNNIN_AUTH=off uv run python -m munnin で同じように 127.0.0.1:8200 上で起動します。

ホスティング

デフォルトはトークンモードです。すべての /mcp および /api 呼び出しには、このサーバー向けのトークンを発行する OIDC 発行者から取得したベアラートークンが必要です（aud = https://<your-host>/mcp）。サインインしたユーザーには、それぞれ専用のテナントが割り当てられます。MUNNIN_PUBLIC_BASE_URL と MUNNIN_LOGTO_ENDPOINT を設定して TLS の背後に配置し、https://<your-host>/mcp を claude.ai のコネクターまたは claude mcp add に入力します。発行者の要件、単一識別子のルール、ビルド済みイメージについては、デプロイ方法をご覧ください。

開発

uv sync
uv run pytest        # 446 tests
uv run ruff check

アーキテクチャ全体、ツールとエンドポイントの概要、データモデル、既知の課題については、docs/README.mdをご覧ください。

ライセンス

Apache License 2.0 — Copyright 2026 Alviandi Widiasto。control-files サブモジュール（agent-memory-system）も同じライセンスのため、サブモジュールを含むクローンは全体を通して同一のライセンスが適用されます。