mcpField
M
Munnin — an agent identity server

Munnin — an agent identity server

远程服务
munnin.lok.quest记忆与知识04 天前更新
代码仓库访问官网

关于 Munnin — an agent identity server

Munnin 是面向 AI Agent 的身份与记忆 MCP 服务，将持久身份、经历和知识与记忆维护流程一并提供。支持本地单租户运行，也可通过 OIDC 按用户隔离托管。

主要功能

  1. 01持久化身份与记忆
  2. 02提供记忆维护流程
  3. 03SQLite 存储
  4. 04本地模式与 OIDC 令牌模式

适用场景

  1. 01为 Agent 保存跨会话身份与经历
  2. 02通过记忆流程创建和维护 Agent
  3. 03为不同登录用户隔离记忆租户

MCP 相关

通过 MCP 提供 Agent 身份与记忆数据，以及用于维护记忆的流程和工具。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://munnin.lok.quest/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

Munnin — Agent 身份服务

Munnin 为 AI Agent 提供持久的自我认知——身份、推理模式、情绪时刻、情景历史、知识——并通过 MCP，在数据旁提供维护这些记忆的流程。它是 agent-memory framework 的记忆服务：Agent 从中苏醒时，成为它本身，而非一堆回忆起来的事实；并通过同一套规范写回记忆。

Python · FastMCP · FastAPI · SQLite。Apache-2.0。无需身份提供商，在笔记本电脑上五分钟即可运行。

五分钟运行

需要 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") 会引导你创建第一个 Agent。无需登录：这是本地模式——单个租户，仅可从这台机器访问，且服务不会以其他方式启动（了解此保护机制的工作方式）。

没有 Docker？uv sync && MUNNIN_AUTH=off uv run python -m munnin 会在 127.0.0.1:8200 上执行相同操作。

托管

默认模式为令牌模式：每次 /mcp 和 /api 调用都需要来自 OIDC 颁发者的 bearer 令牌，该颁发者会将令牌绑定到此服务（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 — 版权所有 2026 Alviandi Widiasto。control-files 子模块（agent-memory-system）采用相同许可证，因此包含子模块的克隆项目始终只涉及一种许可证。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。