使用说明
atproto代理上下文
便携式AI代理上下文，存储在AT协议上。
你的人工智能代理会了解你的一些东西，这些东西将越来越有价值——偏好、项目、决策、关系。如今，这种背景被锁定在专有系统中（OpenAI、Anthropic，无论贵公司明年购买什么企业AI）。
该项目定义了一个开放词典规范和MCP服务器，用于在用户的AT协议个人数据服务器（PDS）上存储AI代理上下文，因此您的代理内存会随着 你而不是平台。
想法
这 AT协议 （背后的开放式基础设施 蓝天)为每个用户提供一个个人数据服务器——一个便携式、用户控制的数据存储。应用程序在您的许可下读取和写入您的PDS。
这个项目增加了一个新东西： agent.context 词典——一种用于AI代理内存的结构化记录类型，任何代理或应用程序都可以在用户授权的情况下读/写。
这使得：
- 在不失去代理对您的了解的情况下切换AI提供商
- 看看你的经纪人对你了解多少
- 随时编辑或撤销代理内存
- 任何应用程序都可以请求访问您的上下文——您可以控制谁可以访问它
快速启动
1.安装依赖项
bun install
2.设置环境变量
复制模板并填写您的凭据：
cp .env.example .env
| 变量 | 描述 |
|---|---|
ATPROTO_HANDLE |
您的Bluesky手柄（例如。 yourname.bsky.social) |
ATPROTO_APP_PASSWORD 一 应用程序密码 （不是您的帐户密码） |
|
ATPROTO_PDS_URL |
PDS URL（默认值： https://bsky.social) |
3.运行服务器
bun run mcp-server/index.ts
4.在Claude Desktop中配置
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"atproto-agent-context": {
"command": "bun",
"args": ["run", "/absolute/path/to/mcp-server/index.ts"],
"env": {
"ATPROTO_HANDLE": "yourname.bsky.social",
"ATPROTO_APP_PASSWORD": "xxxx-xxxx-xxxx-xxxx",
"ATPROTO_PDS_URL": "https://bsky.social"
}
}
}
}
5.在Cursor/其他MCP客户端中配置
添加到您的 .cursor/mcp.json （或同等）：
{
"mcpServers": {
"atproto-agent-context": {
"command": "bun",
"args": ["run", "/absolute/path/to/mcp-server/index.ts"],
"env": {
"ATPROTO_HANDLE": "yourname.bsky.social",
"ATPROTO_APP_PASSWORD": "xxxx-xxxx-xxxx-xxxx",
"ATPROTO_PDS_URL": "https://bsky.social"
}
}
}
}
MCP工具
| 工具 | 说明 |
|---|---|
append_context |
将新的上下文记录写入PDS（不可变的仅可追加日志条目） |
get_context |
读取按以下条件筛选的最近上下文记录 contextId |
list_contexts |
列出所有唯一 contextId PDS上存储的值 |
状态
🚧 早期——定义规范。欢迎投稿和讨论。
结构
/lexicon # atproto lexicon definitions (agent.context schema)
/mcp-server # MCP server (Bun + TypeScript + fastmcp)
/docs # Spec, design decisions, prior art
/examples # Example agent context records
路线图
- [x] 定义最小值
agent.context词典v0 - [x] 构建MCP服务器（TypeScript、atproto SDK）
- []原型：使用atproto PDS作为内存存储的代理
- []权限模型——代理如何请求/作用域访问
- []atproto上的短视频内容（相关：atproto的TikTok）
先前艺术及相关作品
- AT协议文档
- Bluesky词典参考
- 模型上下文协议（MCP） --Anthropic代理工具访问标准
- W3C DID+AI代理的可验证凭据 --去中心化基础设施上的代理身份
- 新美国OTI——人工智能代理记忆与隐私 --政策框架
贡献
打开一个问题来讨论词典规范。这还为时过早，设计决策尚未确定。
许可证
麻省理工学院
