muninn

🐦‍⬛ AI 代理的持久记忆中枢

为AI代理提供持久化项目记忆层,通过Rust高性能引擎实现95%令牌节省的精准上下文检索,强制协议确保跨会话架构一致性。

收藏
11.1k
安装
2.5k
版本
2.1.11
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Muninn MCP 是一种面向 AI 开发者的记忆基础设施,通过 Model Context Protocol (MCP) 为 AI 代理建立持久化的项目上下文层。其工作流程遵循严格的"Gate Keeper"协议:

1. brain_check(强制入口):每次会话开始时必须调用,加载项目架构规则与历史决策
2. add_memory(知识沉淀):将解决的 Bug、设计模式、架构选择保存为 Git 友好的 Markdown 文件

3. search_context(精准检索):利用 Rust 编写的 CXP 引擎进行毫秒级语义搜索,替代全文件读取

显著优点

  • 强制上下文一致性:通过协议层面的 brain_check 强制要求,根治 AI "失忆"问题
  • 极端令牌效率:声称 95% 令牌节省,对长上下文模型成本敏感场景极具价值
  • 透明可审计:纯 Markdown 存储,无黑盒数据库,便于版本控制和人工审查
  • 跨客户端兼容:支持 Claude Desktop、Antigravity、OpenCode 等主流 MCP 客户端

潜在缺点与局限性

  • 强制协议摩擦MUST 级指令可能与用户自由探索的意图冲突,新手可能误触
  • 本地二进制依赖:Rust CXP 引擎需要本地构建/分发,跨平台部署存在摩擦
  • 版本 2.1.11 的成熟度:作为相对较新的协议层,企业级生产环境的长期稳定性待验证
  • "95% 节省"声明:缺乏第三方基准测试佐证,实际收益高度依赖使用模式

适合人群

  • 管理复杂代码库、需要多会话 AI 协作的技术负责人
  • 为团队建立 AI 编码规范、担心架构漂移的工程经理
  • 上下文令牌成本敏感、频繁处理大型代码库的独立开发者

常规风险

  • 协议僵化风险:过度依赖 brain_check 可能使 AI 代理失去灵活应变能力
  • 记忆污染:低质量的 add_memory 操作会累积噪声,降低检索有效性
  • 本地存储安全~/.muninn/memory 的明文 Markdown 可能意外泄露敏感代码片段至 Git

muninn 内容

server文件夹
dist文件夹
手动下载zip · 16.9 kB
brain_lock.jstext/javascript
请选择文件