agentprofile

agentprofile

让 Agent 的身份随处相伴。 一个档案——技能、凭据和 记忆——通过单个 MCP URL 同步到每个 Agent 工具。开源、 零知识，也可托管在你自己的 Cloudflare 账户中。

你使用的每个 AI 工具——Claude Code、Cursor、Codex——都从零开始：各自的 技能、各自粘贴的 API 密钥、各自的健忘症。agentprofile 为它们提供一个 共享的大脑。

现已上线： 托管于 https://agentprofile.everyai-com.workers.dev · 控制面板位于 /app

连接（任意 MCP 客户端）

这是一个远程 MCP 服务（Streamable HTTP）——无需安装，只需一个 URL：

https://agentprofile.everyai-com.workers.dev/mcp

支持两种身份验证方式：

• OAuth（推荐）——支持 MCP OAuth 的客户端会从 URL 自动发现它，并显示授权页面。
• Bearer token——运行 npx @magicteams_ai/agentprofile 获取令牌，或调用 POST /profiles。

claude mcp add --transport http agentprofile https://agentprofile.everyai-com.workers.dev/mcp

claude mcp add --transport http agentprofile https://agentprofile.everyai-com.workers.dev/mcp \
  --header "Authorization: Bearer ap_…"

{
  "mcpServers": {
    "agentprofile": {
      "url": "https://agentprofile.everyai-com.workers.dev/mcp",
      "headers": { "Authorization": "Bearer ap_…" }
    }
  }
}

export AGENTPROFILE_TOKEN="ap_…"
codex mcp add agentprofile --url https://agentprofile.everyai-com.workers.dev/mcp --bearer-token-env-var AGENTPROFILE_TOKEN

codex mcp add agentprofile --url https://agentprofile.everyai-com.workers.dev/mcp

{
  "servers": {
    "agentprofile": {
      "type": "http",
      "url": "https://agentprofile.everyai-com.workers.dev/mcp"
    }
  }
}

也可以直接运行 npx @magicteams_ai/agentprofile，它会为检测到的每个客户端配置连接。

60 秒演示

npx @magicteams_ai/agentprofile

这会在托管实例上创建一个匿名档案（无需注册），自动检测已安装的 MCP 客户端，并写入其配置。重启你的工具，然后：

1. 在 Claude Code 中："记住，我更喜欢 pnpm，而不是 npm。"
2. 在 Cursor 中："我更喜欢哪个包管理器？"

它会记住。这就是你的档案，随处可用。

此代码仓库包含什么（第 1 阶段）

这是总体计划中的第 1 阶段实现：一个可端到端运行的基础框架，通过 MCP 在不同工具间同步技能和记忆。凭据（零知识）、OAuth、语义召回和技能注册表将在后续阶段推出——请参阅路线图。

Web 界面

• / — 着陆页，提供一键安装命令和产品介绍。
• /app — 在线控制面板。粘贴你的令牌（或点击“创建新档案”），即可实时查看技能和记忆更新：任何 Agent 调用 remember 时，该事实都会通过 WebSocket 立即显示。直接在页面上添加或删除记忆和技能。
• /setup-prompt — “使用你的 Agent 设置”提示词：将其粘贴到 Claude Code 或 Cursor，你自己的 Agent 就会为你安装并验证 agentprofile。

工作原理

agent tool ──Streamable HTTP──▶ Worker ──idFromName(profileId)──▶ ProfileDO
  (Claude Code / Cursor)          /mcp                            per-user SQLite
                                                                  • facts (memory)
                                                                  • skills

• 每位用户对应一个 Durable Object，它是真实数据的唯一来源。它会在每次调用时验证档案的密钥，并管理该档案的记忆和技能。
• Bearer token = ap_<profileId>.<secret>。 profileId 用于路由到 DO；DO 会验证密钥的 SHA-256 哈希值。无需中央令牌表。
• MCP 接口包含 6 个工具：get_context、list_skills、get_skill、 remember、recall、forget。刻意保持精简——客户端每轮对话都会承担每个描述字节的开销（已通过测试固定）。

本地运行

npm install
npm run dev            # starts the Worker on http://localhost:8787

在另一个终端中：

# point the CLI at your local server
AGENTPROFILE_SERVER=http://localhost:8787 npx @magicteams_ai/agentprofile

运行测试并进行类型检查：

npm --workspace apps/worker run test
npm --workspace apps/worker run typecheck

部署自己的实例（自托管）

agentprofile 可部署在你自己的 Cloudflare 账户上——免费的 Workers 套餐足以满足个人使用需求。

cd apps/worker
npx wrangler r2 bucket create agentprofile-bundles
npx wrangler deploy
# then set PUBLIC_BASE_URL to your deployed URL and connect with:
AGENTPROFILE_SERVER=https://agentprofile.<you>.workers.dev npx @magicteams_ai/agentprofile

路线图

• **P1：**MCP 服务 + ProfileDO、6 个工具、记忆 + 技能、instant-profile CLI、实时仪表板。✅
• P2：按客户端设置授权 + 审计日志，支持实时执行 + 仪表板访问面板 ✅；MCP 会话（Mcp-Session-Id）✅；通过 Workers AI embeddings 实现语义检索（关键词回退）✅；可插拔的记忆提供方（内置默认提供方 + Mem0 + Supermemory 适配器，/memory-config）✅；支持发现、动态注册和授权页面的 OAuth 2.0 + PKCE 授权流程 ✅。
• **P3：**零知识凭据（客户端 E2E）、即时注入、审批流程。
• **P4：**一键部署到 Cloudflare、签名技能注册表、格式转换器。
• **P5：**团队、SSO、托管云服务。

请参阅 docs/ 中的完整计划。

贡献

欢迎根据 DCO 贡献—— 使用 git commit -s 对提交进行签署。有关负责任披露的信息，请参阅 SECURITY.md。

许可证

Apache-2.0。

属于 everyai-com Agent 技术栈的一部分

为本地优先、受治理的 AI Agent 提供开源基础设施：

• distillory — 可在摄取时进行推理的本地优先记忆引擎
• agent-ready — 将任意应用转变为 MCP 服务 + API + CLI，默认安全
• primer — 注入任意 Agent 的实时业务上下文
• plainsync — 面向人类 + Agent 的本地优先 Markdown 工作区
• argus — 通过并行浏览器测试进行云原生软件验证
• mintly-alternative — 面向人类 + AI Agent 的可自托管文档层
• talltrack — 输入销售通话，输出可发布内容

由 Phanindra Reddy 构建 · magicteams.ai