使用说明
石堆
为您的代理共享图形知识库。
黑曜石般结构化、反向链接的标记笔记——所有人工智能代理都可以通过以下方式访问 主控程序WikiLinks、反向链接、每日笔记、全文搜索和一个合理的最小工具界面，旨在成为Claude、Cursor和任何MCP客户端之间的可共享知识库。
立即尝试 凯恩广场
运作原理
- 登录 在 凯恩广场 并创建一个工作区
- 连接您的代理 --将MCP端点添加到Claude Desktop、Cursor、Claude Code或任何MCP客户端
- 你的特工们共享一个大脑 --笔记、实体、会议日志和项目上下文在对话和工具中持续存在
{
"mcpServers": {
"cairn": {
"url": "https://cairn.place/<workspace-id>/mcp"
}
}
}
想先试试吗？ 使用 default workspace——这是一个对任何经过身份验证的用户开放的共享沙箱，不需要邀请：
{
"mcpServers": {
"cairn": {
"url": "https://cairn.place/mcp"
}
}
}
MCP工具
一个最小的、专注的界面——8个工具，涵盖了代理所需的一切：
| 工具 | 说明 |
|---|---|
cairn_read |
阅读笔记、特定章节或只是元数据 |
cairn_write |
使用frontmatter、标签和别名创建或覆盖注释 |
cairn_list |
列出带有路径前缀过滤、排序和分页的注释 |
cairn_search |
全文+标签+带片段的反向链接搜索 |
cairn_daily |
读取或附加到今天的每日笔记（自动创建） |
cairn_patch |
在现有注释中添加、预置或查找和替换 |
cairn_delete |
删除注释并清理其索引条目 |
cairn_links |
在注释周围遍历反向链接图 |
注释是用YAML frontmatter标记的。维基链接([[target]])自动索引以进行反向链接遍历和别名解析。
看 MCP规范 对于完整的工具模式。
特性
- 维基链接和反向链接 —
[[link]]具有自动图索引和别名解析的语法 - 每日笔记 --具有附加/前置操作的时区感知日报
- 全文搜索 --带前缀匹配、标签过滤和反向链接查询的反向索引
- 工作区 --具有成员管理和基于角色的访问的隔离保管库
- 管理用户界面 --浏览vault，查看语法突出显示的markdown文件，管理成员和设置
自足执行
Cairn在Cloudflare Workers上运行R2、KV和持久对象。请参阅 架构文档 了解详情。
npm install
cp .dev.vars.example .dev.vars # add Google OAuth credentials
npm run dev # http://localhost:8788
看 部署说明 用于生产设置。
建筑
- R2 --注释内容（markdown+YAML frontmatter）和工作区元数据
- 耐用对象（SQLite） --反向链接、搜索词、别名、注释元数据索引
- MCP（McpAgent） --直接读/写R2，将轻量级元数据发送到索引
- 谷歌OAuth --MCP客户端和浏览器UI的身份验证
部署
npx wrangler r2 bucket create cairn-storage
npx wrangler kv namespace create cairn-oauth-kv
# Update wrangler.jsonc with the KV namespace ID
npx wrangler secret put GOOGLE_CLIENT_ID
npx wrangler secret put GOOGLE_CLIENT_SECRET
npx wrangler secret put COOKIE_ENCRYPTION_KEY
npx wrangler secret put ADMIN_EMAIL
npx wrangler deploy
谷歌云OAuth客户端配置：
- 授权重定向URI：
https://your-domain/callback - 范围：
openid email profile
