Agentdrive

AgentDrive MCP 服务

适用于 AgentDrive 的官方 Model Context Protocol 服务——一个跨 Agent 的产物工作区，可在 Claude Code、Codex、Cursor、LangGraph 和任何支持 MCP 的宿主之间提供溯源信息和可移植存储。

为你的 Agent 提供共享的持久化工作区：支持版本控制的文件、对以往 Agent 产物的语义检索、运行日志和跨 Agent 归属信息——这样，下一个会话（无论使用什么工具）都能从上一个会话中断的地方继续。

• 网站： https://agentdrive.sh
• 文档： https://agentdrive.sh/docs
• npm： @adrive/mcp-server
• 托管端点： https://mcp.agentdrive.sh/mcp

Claude Code 插件

此仓库同时也是 Claude Code 插件市场。该插件会在后台捕获每个会话，并可在 Codex、OpenCode、Gemini CLI 或 Cursor 中恢复会话：

/plugin install agentdrive --marketplace Rakesh1002/agentdrive-mcp

对于低于 2.1.275 的 Claude Code，请运行 /plugin marketplace add Rakesh1002/agentdrive-mcp ，然后运行 /plugin install agentdrive@agentdrive。使用 /agentdrive:login 登录。

获取 API 密钥（免费）

在 https://app.agentdrive.sh 创建密钥——无需信用卡。免费套餐 （1 个工作区、1 GB 存储空间、10k 个嵌入）永久免费。

两种连接方式

1. 托管（无需安装）——Streamable HTTP

将支持远程服务的任意 MCP 客户端指向托管端点，并将密钥作为 bearer token 传入：

URL:    https://mcp.agentdrive.sh/mcp
Header: Authorization: Bearer agentdrive_live_xxx

也可以通过 Smithery 一键安装。

2. 本地（stdio）——通过 npx

{
  "mcpServers": {
    "agentdrive": {
      "command": "npx",
      "args": ["-y", "@adrive/mcp-server"],
      "env": {
        "AGENTDRIVE_API_KEY": "agentdrive_live_xxx"
      }
    }
  }
}

将该代码块添加到宿主的 MCP 配置中：

• Claude Desktop： claude_desktop_config.json
• Cursor： ~/.cursor/mcp.json
• Claude Code： 安装插件（见上文），插件还会捕获会话
• Codex / Cline / Continue / Zed： 使用上文标准的 mcpServers 代码块

最快捷的方式是使用 AgentDrive 安装程序，它会自动配置所有检测到的宿主：

curl -fsSL agentdrive.sh/install | sh

配置

环境变量	必需	默认值	说明
AGENTDRIVE_API_KEY	否	由 adrive auth login 保存的密钥	你的 AgentDrive API 密钥（agentdrive_live_...）。若未设置，则使用 ~/.config/agentdrive/config.json 中的密钥，因此客户端配置无需内联密钥。
AGENTDRIVE_API_URL	否	https://app.agentdrive.sh	覆盖 API 端点（可自托管的 worker）。
AGENTDRIVE_AGENT_PLATFORM	否	unknown	调用服务的 Agent 运行时——用于跨 Agent 溯源。可选值：claude-code、codex、opencode、gemini-cli、cursor、langgraph、crewai、autogen、hermes、openclaw、unknown。
AGENTDRIVE_AGENT_ROLE	否	—	自由文本角色标签（例如 planner、reviewer），用于区分同一平台上的多个 Agent。

工具

共有 22 个工具，涵盖文件、记忆、会话、协作、组织和溯源。stdio 服务会根据工作目录确定当前项目（优先使用 git 远程地址，否则使用仓库路径），并以此限定 drive_sessions 和 drive_resume 的范围。

工具	类别	描述
drive_context	memory	自动提取与你即将开始的任务最相关的过往产物。
drive_search	memory	在组织的产物中进行语义搜索。
drive_recall	memory	回忆 Agent 写入的持久事实／偏好。
drive_sessions	sessions	列出此项目在 Claude Code、Codex、OpenCode、Gemini CLI 和 Cursor 中的近期 Agent 会话。
drive_resume	sessions	从先前的会话中加载精简交接信息（目标、涉及的文件、近期对话）；默认加载来自其他运行环境的最新会话。
drive_write	files	写入 Markdown 文件（自动创建版本）。
drive_read	files	读取文件内容。
drive_list	files	列出工作区中的文件。
drive_delete	files	删除文件。
drive_versions	files	查看文件的版本历史。
drive_share	collaboration	生成分享链接（可选设置邮箱验证）。
drive_comment	collaboration	对文件发表评论。
drive_feedback	collaboration	读取他人对文件的评论。
drive_activity	provenance	查看近期工作区活动（写入、评论、分享）。
drive_log_run	provenance	记录 Agent 运行信息（任务、状态、产物、身份）。
drive_invite	org	通过电子邮件邀请人员加入组织。
drive_roles	org	通过电子邮件分配、列出或移除工作区访问权限。
drive_org	org	查看组织详情：Agent、成员、套餐和用量。
drive_sandbox_clone	sandbox (experimental)	将 git 仓库克隆到专属工作区的 Linux 沙盒中。
drive_sandbox_exec	sandbox (experimental)	在沙盒中运行 shell 命令。
drive_sandbox_read	sandbox (experimental)	从沙盒文件系统读取文件。
drive_sandbox_commit	sandbox (experimental)	暂存并提交沙盒工作树。

drive_sandbox_* 工具要求 AgentDrive worker 使用 Cloudflare Containers 套餐；否则会正常降级并显示“未配置”消息。

为什么选择 AgentDrive

Agent 在每次会话结束和每次切换工具时都会丢失上下文。AgentDrive 是共享底层平台：一个工作区，供每个 Agent 使用，并保留完整溯源信息。在 Claude Code 中写入一次，在 Cursor 中回忆内容，再交接给 Codex——每次调用都会归属到正确的主体和平台。

开发

npm install
npm run build      # tsc -> dist/
npm test           # vitest

许可证

Apache-2.0。请参阅 LICENSE。