Audrey MCP 服务说明文档

1. 服务概述一句话简介为AI代理提供持久记忆能力的本地记忆运行时让代理能够记住过去的错误、项目规则和经验教训实现跨会话的连续性。服务名称Audrey版本号v0.22.2开发者/提供方Evilander协议类型MCP (Model Context Protocol)2. 核心功能该MCP服务提供以下主要功能memory_recall通过语义相似度查找持久化上下文memory_preflight在执行操作前检查之前的失败、风险、规则和相关程序memory_reflexes将记忆证据转换为代理可遵循的触发-响应指导memory_validate在操作后关闭循环记录有用、已使用或错误的结果memory_dream将事件整合为原则并应用衰减机制audrey impact/doctor告诉人类或CI系统运行时是否正在工作并准备就绪3. 使用场景该服务适合在以下情况下使用AI代理需要记住之前的错误和教训跨会话保持项目特定的规则和偏好检测和避免重复的失败命令构建具有长期记忆能力的智能代理本地优先、隐私保护的记忆存储需求4. 接入方式4.1 服务端点MCP stdio服务器20工具支持状态/最近/原则资源和简报/回忆/反思提示REST APIHono服务器端口默认7437路由/health和/v1/*4.2 认证与权限本地服务默认无需认证非本地访问需设置AUDREY_API_KEY环境变量4.3 数据格式存储本地SQLite sqlite-vec无需托管数据库支持多种嵌入提供者local、gemini、openai、mock4.4 服务器配置快速安装npx audrey doctor npx audrey demo npx audrey install生成配置块npx audrey mcp-config codex npx audrey mcp-config generic npx audrey mcp-config vscodeOllama本地代理AUDREY_AGENTollama-local-agent npx audrey serve curl http://localhost:7437/health5. 接口定义代理需求REST路由功能描述操作前检查记忆POST /v1/preflight检查之前的失败和风险获取操作的反射规则POST /v1/reflexes获取触发-响应指导存储有用的观察POST /v1/encode编码并存储记忆回忆相关上下文POST /v1/recall语义搜索记忆获取回合大小的记忆包POST /v1/capsule获取紧凑的记忆摘要健康检查GET /v1/status检查服务状态6. 快速开始6.1 环境要求Node.js 20可选Python用于Python客户端可选Docker用于容器化部署6.2 示例代码JavaScript使用import { Audrey } from audrey; const brain new Audrey({ dataDir: ./audrey-data, agent: support-agent, embedding: { provider: local, dimensions: 384 }, }); await brain.encode({ content: Stripe returns HTTP 429 above 100 req/s, source: direct-observation, tags: [stripe, rate-limit], }); const memories await brain.recall(stripe rate limit); await brain.waitForIdle(); brain.close();Python使用pip install audrey-memory from audrey_memory import Audrey brain Audrey(base_urlhttp://127.0.0.1:7437, agentsupport-agent) memory_id brain.encode(Stripe returns HTTP 429 above 100 req/s, sourcedirect-observation) results brain.recall(stripe rate limit, limit5) brain.close()7. 注意事项每个租户/环境设置独立的AUDREY_DATA_DIR以实现隔离显式设置AUDREY_EMBEDDING_PROVIDER和AUDREY_LLM_PROVIDER在提供者或维度更改前备份SQLite数据目录将API密钥和凭据排除在编码的记忆内容之外定期运行npx audrey dream以保持整合和衰减更新许可证MIT