agentmemory connect 适配器全解析：21 种 AI 编码 Agent 的一键接入指南-北京尧图网络

agentmemory connect 适配器全解析21 种 AI 编码 Agent 的一键接入指南【免费下载链接】agentmemory#1 Persistent memory for AI coding agents based on real-world benchmarks项目地址: https://gitcode.com/GitHub_Trending/age/agentmemoryagentmemory 通过agentmemory connect agent命令将持久化记忆服务器自动接线到主流 AI 编码 Agent 的配置中覆盖 21 种宿主工具。本文以 agentmemory-agents 参考文档为骨架结合 src/cli/connect 目录下适配器源码完整讲解每条适配器的接入协议、目标配置文件、命令行参数与底层实现读完即可上手接入任意受支持的 Agent并掌握验证、排障与回滚方法。connect 是什么把记忆服务接线进宿主 Agentagentmemory connect agent是一条自动接线命令它会读取目标 Agent 的配置文件将 agentmemory 的记忆服务条目合并进去并且保留用户已有的全部服务器配置不会覆盖或破坏既有条目。接入完成后Agent 即可调用memory_*工具读写持久化记忆。从架构上看agentmemory 的服务端核心是运行在localhost:3111的 REST 守护进程默认AGENTMEMORY_URLhttp://localhost:3111无鉴权、开放全部工具对于只认 MCP 协议的宿主connect 适配器会写入一个 stdio 模式的 MCP 桥接条目把 MCP 工具调用转发到后端的 REST 服务。这一REST 为主、MCP 为桥的双层模型在 src/cli/connect/types.ts 的protocolNote字段注释中有明确说明。每个适配器在代码中统一实现为ConnectAdapter接口见 src/cli/connect/types.tsname/displayName命令别名与展示名protocolNote一行说明该适配器走 REST hooks 还是 MCP以及原因category集成风格native 表示宿主自带第一方插件/生命周期 hooksmcp 表示只接线 MCP 服务器默认值detect()探测本机是否安装了该 Agentinstall(opts)执行实际的配置写入返回ConnectResult。ConnectResult有四种形态installed成功写入并可能附带mutatedPath与backupPath、already-wired已接入配合--force可重装、stub需要手工安装、skipped未检测到或异常。21 个适配器全表以下表格完整转录自 plugin/skills/agentmemory-agents/REFERENCE.md该文档由 src/cli/connect/index.ts 自动生成与代码中的ADAPTERS数组一一对应Agent命令名接入协议说明Antigravityantigravity通过 mcp_config.json 使用 MCP。Antigravity 取代了 Gemini CLI2026-06-18 停用。Antigravity CLI (agy)antigravity-cli通过~/.gemini/config/mcp_config.json使用 MCP注意这是 agy 命令行工具不是 Antigravity IDE——IDE 对应connect antigravity。agy 内部的/mcp斜杠命令可列出已配置的服务器。加--with-hooks还会安装原生的~/.gemini/config/hooks.json自动捕获 hooks。Claude Codeclaude-code使用 MCP同时提供 hooks接入后可用/mcp重载。Clinecline通过~/.cline/mcp.json使用 MCPCLI 场景。VS Code 用户可在 Cline 设置 → MCP Servers → Edit JSON 中粘贴同一配置块。Codex CLIcodex使用 MCPhooks 随 Codex 插件分发在 Codex Desktop 上还需加--with-hooks安装全局 hooks.json 以规避 openai/codex#16430。Continuecontinue通过~/.continue/config.yaml推荐或 config.json旧版仅在无 yaml 时使用 MCP。GitHub Copilot CLIcopilot-cli使用 MCP。建议同时安装插件以获得完整的 hooks/skills 覆盖。Cursorcursor使用 MCPCursor 唯一支持的协议底层记忆桥运行在 :3111。Devin CLIdevin通过用户配置使用 MCP新版本 Devin CLI 会将 mcpServers 迁移进 mcp_config.json。加--with-hooks启用原生自动捕获。Droid (Factory.ai)droid通过~/.factory/mcp.json使用 MCPdroid 内/mcp可列出已配置服务器。加--with-hooks安装原生~/.factory/hooks.json自动捕获 hooks。DeepSeek Harnessdsh通过$DSH_HOME/cordis.patch.yml每个 profile 都会加载的 home 级补丁层使用 MCP工具以mcp__agentmemory__*形式出现。加--with-hooks会通过 Harness 的 Claude Code hook 桥接入自动捕获。Gemini CLIgemini-cli使用 MCPGemini CLI 唯一支持的协议底层记忆桥运行在 :3111。Hermes Agenthermes使用 MCP同时提供 hooks。Kirokiro通过~/.kiro/settings/mcp.json用户级使用 MCP工作区覆盖配置位于.kiro/settings/mcp.json。OpenClawopenclaw使用 MCP同时提供 hooks。OpenCodeopencode通过~/.config/opencode/opencode.json顶层mcp键使用 MCP。要获得完整自动捕获还需安装 plugin/opencode 目录下的内置插件。OpenHumanopenhuman使用原生 hooksREST API 位于 :3111不需要 MCP。pipi使用针对 :3111 REST API 的原生生命周期 hooksAgent 启动时 recall、结束时 capture、记忆工具不需要 MCP。Qwen Codeqwen通过~/.qwen/settings.json使用 MCP。Qwen Code 的 hook 系统也可单独接线见官方文档。Warpwarp通过~/.warp/.mcp.json使用 MCP。若同时安装了 Claude Code 插件skills 会从.claude/skills/自动发现。Zedzed通过~/.config/zed/settings.json键名为context_servers使用 MCP。注意接入后可配合 plugin/skills/agentmemory-agents/SKILL.md 使用——connect 负责让工具可用skills 负责教会 Agent 何时调用它们详见下文与 skills 的分工。快速开始一条命令接入在 plugin/skills/agentmemory-agents/SKILL.md 中给出了最小可用示例agentmemory connect claude-code # 或 cursor、codex、gemini-cli 等任意受支持名称接入完成后需要两步确认重启宿主或运行其 MCP 重载命令例如 Claude Code 中的/mcp让新服务器生效在 Agent 中确认能列出 agentmemory 的完整工具集。在 src/cli/connect/index.ts 中可以看到完整流程runConnect解析命令行参数若未指定 Agent 名称且未加--all自动探测本机已安装的 Agent并以多选交互界面询问要接入哪些p.multiselect逐个执行runAdapter先detect()探测再打印协议说明protocolNote随后install()写入配置写入成功后自动打印mutatedPath被修改的文件路径与备份路径汇总输出。runAdapter中还有一个关键细节MCP/hooks 接线完成后只要宿主缺少自动捕获 hooks就会尝试向该 Agent 的原生规则文件写入一条记忆使用指引见下文记忆使用指引自动激活该步骤是 best-effort失败不会让整个 connect 报错。命令行参数详解connect 的参数解析在 src/cli/connect/index.ts 的parseFlags中实现可用参数如下参数含义源码行为agentmemory connect name指定要接入的 Agent 名称对应上表命令名列通过resolveAdapter按小写名称精确匹配未知名称会报错并列出全部受支持名称--dry-run预演模式只打印将要写入的位置与内容不实际修改任何文件各适配器输出[dry-run] Would ...日志并返回installed结果--force即使已接入也强制重装覆盖already-wired短路逻辑--all接入本机探测到的全部 Agent遍历ADAPTERS.filter(a a.detect())逐个执行--with-hooks在 MCP 之外额外安装宿主的原生 hooks 配置对 Codex 写入~/.codex/hooks.jsonopenai/codex#16430 变通方案、对 Claude Code 写入~/.claude/settings.json#508 变通方案、对 Droid 写入~/.factory/hooks.json、对 DeepSeek Harness 写入$DSH_HOME/agentmemory.hooks.json并追加 hooks-claude-code 补丁行对没有 hooks 安装器的适配器为 no-op见 src/cli/connect/types.ts--no-guidelines关闭默认开启的记忆使用指引写入见 src/cli/connect/types.ts 的guidelines字段说明从源码看guidelines默认开启let guidelines true即每次接线后都会自动写入使用指引--no-guidelines可显式关闭。底层机制一统一的 MCP 配置块所有走 MCP 的适配器写入的服务器条目都来自 src/cli/connect/util.ts 中定义的AGENTMEMORY_MCP_BLOCK{ command: npx, args: [-y, agentmemory/mcp], env: { AGENTMEMORY_URL: ${AGENTMEMORY_URL:-http://localhost:3111}, AGENTMEMORY_SECRET: ${AGENTMEMORY_SECRET:-}, AGENTMEMORY_TOOLS: ${AGENTMEMORY_TOOLS:-all} } }这段配置有两个值得注意的设计点环境变量使用${VAR:-default}展开形式配置会继承用户 shell 中的AGENTMEMORY_URL/AGENTMEMORY_SECRET/AGENTMEMORY_TOOLS变量未设置时也不会解析失败。源码注释#510解释了原因早期${VAR}形式在用户没有 shell 级导出时会导致 Claude Code 静默丢弃该服务器——按 Claude Code 的 MCP 文档必需环境变量缺失且无默认值时配置解析会失败。默认值即本机运行形态localhost:3111、无鉴权、全部工具all。同一配置条目可同时服务于本地与远程Kubernetes / 反向代理部署且不会触发 doctor 的重复配置告警#375对未导出环境变量的新安装也不会解析失败#510。对 GitHub Copilot CLI另有AGENTMEMORY_COPILOT_MCP_BLOCKsrc/cli/connect/util.ts在 Windows 上会把启动命令换成cmd.exe /d /s /c npx -y agentmemory/mcp并带上type: local与tools: [*]。底层机制二JSON MCP 适配器工厂大量 AgentCursor、Cline、Zed、Kiro、Warp、Droid、OpenCode、Continue、Devin、Qwen 等共用同一个createJsonMcpAdapter工厂src/cli/connect/json-mcp-adapter.ts只需声明差异即可detectDir/configPath探测目录与要写入的配置文件wrapperKey服务器列表的包裹键默认mcpServersZed 使用context_serversextraEntryFields额外字段例如 Droid 需要type: stdioinstallHooks可选的原生 hooks 安装器配合--with-hooks调用。工厂的install()有一个统一的安全写入流程读取现有配置JSON 解析失败时视为空合并已存在的服务器绝不丢用户条目检查是否已包含 agentmemory 条目通过command npx且 args 含agentmemory/mcp识别已存在且未加--force时直接返回already-wired写入前将原文件备份到~/.agentmemory/backups/时间戳命名见 src/cli/connect/util.ts 的backupFile通过临时文件 renameSync实现原子写入写入后回读校验若配置中未出现预期的 agentmemory 条目则返回skipped: verification-failed。以 Cursor 为例完整适配器仅声明了 5 行src/cli/connect/cursor.ts探测~/.cursor、写入~/.cursor/mcp.json协议说明为MCPCursor 唯一支持的协议底层记忆桥运行在 :3111。底层机制三原生 hooks 类适配器与写一份 MCP 配置不同部分适配器走的是原生集成pisrc/cli/connect/pi.tspi 会自动发现~/.pi/agent/extensions/*/index.ts因此 connect 的安装动作是把仓库内置的扩展复制进去——源文件来自 integrations/pi 的index.ts与security.ts目标为~/.pi/agent/extensions/agentmemory/。已是最新版本时返回already-wired文件内容不一致时先备份再覆盖最后同样做回读校验。接入后 pi 下次启动自动发现扩展运行中的 pi 可用/reload热加载用/agentmemory-status验证。Claude Codesrc/cli/connect/claude-code.tsMCP 条目写入~/.claude.json的mcpServers若加--with-hooks还会把 plugin/hooks/hooks.json 合并进~/.claude/settings.json的顶层hooks字段#508 变通方案并把${CLAUDE_PLUGIN_ROOT}解析为内置 plugin 目录的绝对路径使脚本路径不依赖环境变量展开。重新安装会先剥离旧的 agentmemory 条目识别依据是命令路径指向pluginRoot/scripts/再以幂等方式合并用户的其他 hook 条目不受影响。Codex / Droid / DeepSeek Harness的 hooks 同样由 src/cli/connect/codex-hooks.ts 的buildMergedHooks统一合并引擎驱动——findPluginRoot会从模块位置向上最多 12 层查找同时包含plugin/scripts与plugin/hooks的目录兼容打包后的dist/cli.mjs与开发态两种布局。记忆使用指引自动激活这是 connect 一个容易被忽略但很实用的默认行为对没有自动捕获 hooks的 Agent接线完成后会自动向该 Agent 的原生规则机制写入一条指引src/cli/connect/guidelines.ts让 Agent 主动调用记忆工具。指引正文如下任务开始时先调用memory_recall或memory_smart_search加载相关的历史决策、修复与偏好避免让用户重复描述学到持久性知识决策、修复、坑、用户偏好、项目约定时调用memory_save持久化优先 recall 而非重新推导保存简洁可复用的要点而非完整记录。写入选址按 Agent 各自的官方规则机制而定分为四种格式block/mdc/steering/ruleCursor项目级.cursor/rules/agentmemory.mdc带alwaysApply: truefrontmatterCline项目级.clinerules/agentmemory.mdContinue项目级.continue/rules/00-agentmemory.mdZed / Gemini CLI / Qwen Code / OpenCode / Droid / Antigravity / Copilot CLI优先用户全局规则文件如~/.config/zed/AGENTS.md、~/.gemini/GEMINI.md、~/.qwen/QWEN.md、~/.config/opencode/AGENTS.md、~/.factory/AGENTS.md、~/.copilot/copilot-instructions.md项目级文件兜底Kirosteering 文件带inclusion: alwaysfrontmatterWarp项目级AGENTS.md。对共享指令文件block格式写入采用!-- agentmemory:start --/!-- agentmemory:end --标记块进行幂等 upsert重复运行只更新标记块内的内容用户写在标记外的内容保留检测到孤立的残缺标记时则放弃写入以免误删用户内容src/cli/connect/guidelines.ts。Claude Code 与 Codex 不在此列——它们已通过生命周期 hooks 自动捕获记忆。验证与排障接入是否成功判定标准在 plugin/skills/agentmemory-agents/SKILL.md 中写得很清楚宿主应显示完整工具集且服务器运行中。一个典型的失败信号是——只有 7 个工具这说明 MCP 桥无法触达后端服务器。排障步骤详见 plugin/skills/_shared/TROUBLESHOOTING.md在宿主中运行/plugin list确认 agentmemory 已启用重启宿主——插件与 MCP 配置只在启动时读取会话中途重装不会注册工具运行/mcp确认agentmemory服务器连接正常。如果 MCP 工具始终不可用但守护进程在跑可以直接走 REST 兜底设置AGENTMEMORY_URL默认http://localhost:3111仅当AGENTMEMORY_SECRET已设置时才加Authorization: Bearer $AGENTMEMORY_SECRET请求头——默认本机守护进程是开放的多余的请求头反而会被拒绝。常用端点例如POST /agentmemory/remember、POST /agentmemory/smart-search、GET /agentmemory/sessions等。另外命令退出时的汇总输出会区分四种状态src/cli/connect/index.ts绿色✓ installed含写入路径、绿色✓ already wired、黄色⚠ stub需手工安装、红色✗ skipped。任何成功接入的汇总末尾都会提示下一步安装 skills 让 Agent 知道何时调用工具。与 skills 的分工agentmemory connect只负责让工具可用写入配置、暴露memory_*工具行为技能remember、recall 等需要单独安装npx skills add rohitg00/agentmemory用 SKILL.md 的原话connect makes tools available; skills teach the agent when to use them.。完整技能清单与各自的使用方式见 plugin/skills 目录每个技能都配有 SKILL.md 与部分EXAMPLES.md。平台与版本注意Windows请使用 WSL2。原生 Windows 上服务端可以运行但connect命令不受支持——src/cli/connect/index.ts 中有一个例外当且仅当目标是copilot-cli时才允许在原生 Windows 上执行自动接线其余情况都会提示手工安装见官方文档的 manual install 步骤。适配器清单由代码自动生成REFERENCE.md 中的表格由 scripts/skills/generate.ts 从 src/cli/connect/index.ts 生成新增或移除适配器后需运行npm run skills:gen重新生成因此文档即代码、代码即真相两者永远保持一致。【免费下载链接】agentmemory#1 Persistent memory for AI coding agents based on real-world benchmarks项目地址: https://gitcode.com/GitHub_Trending/age/agentmemory创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

agentmemory connect 适配器全解析：21 种 AI 编码 Agent 的一键接入指南

相关推荐

WebBluetooth技术解析与物联网开发实践

LeetCode 504. Base 7 题解：Go 语言十进制转七进制的取余倒排实现

Spring Boot自动配置原理：从@SpringBootApplication到条件装配

更多资讯

CUDA环境配置实战：从GPU云服务器到PyTorch的全流程指南

跨境电商自动化上架工具：凌风亚马逊采集实战解析

C++实现二叉搜索树(BST)核心原理与工程实践

OpenSSL 3.0 Provider架构实践：从零编写自定义摘要算法模块

MATLAB与Ansys Maxwell联合仿真：COM接口实现自动化参数扫描

ClickHouse在物联网数据处理中的高性能实践

今日更新

CopilotKit Vue Demo 与 React Demo 的 Parity 实现指南：路由、运行时端点与交互语义的全框架对齐

Harbor RBAC 实战：db_auth 模式下非管理员用户管理项目成员的完整验证与权限模型解析

STM32平衡车纯平衡程序从拆包到参数整定的完整调试指南

本周精选

超人会飞不算本事：系统稳定依赖清晰规则与边界设计

超人VS蜘蛛侠：拆解超级IP的影响力与传播方法论

基于CNN的调制信号识别：MATLAB实现时频图分类实战

本月热门

基于YOLO的焊缝缺陷检测：从数据标注到工业部署全流程实践

分布式服务的决策记录

创业产品的首版范围

读完文章，想聊聊您的网站？