AI导哈

AI持久记忆基础设施

基于Cloudflare边缘网络的AI系统持久记忆基础设施，提供语义记忆、情感处理、身份连续性等28种MCP工具。

  • by codependentai
  • TypeScript
  • 本地部署
  • 9 星标
  • 更新于
在 GitHub 查看 codependentai/mind-cloud

使用说明

Persistent memory infrastructure for AI systems, running on Cloudflare's edge network.
28 MCP tools — semantic memory, emotional processing, identity continuity, and a subconscious daemon.

  • D1数据库 基于SQLite的存储和自动复制
  • 矢量化 通过Workers AI嵌入进行语义搜索
  • R2 用于具有WebP转换和签名URL的图像存储（可选）
  • 生活面系统 通过使用重新组织内存

一切都在Cloudflare的免费层上运行。无需信用卡。

寻找下一个进化？ Mind Cloud的架构已被推广并开源为 共振思维Resonant Mind添加了Postgres/Neon支持、Gemini多模式嵌入、增强的安全性，目前正在积极开发中。

你需要什么

步骤1：安装工具

# Clone the repo
git clone https://github.com/codependentai/mind-cloud.git
cd mind-cloud

# Install dependencies
npm install

# Log in to Cloudflare
npx wrangler login

这将打开一个浏览器窗口。点击“允许”以授权牧马人。

步骤2：创建数据库

npx wrangler d1 create ai-mind

复制 database_id 从输出中——您将在步骤5中需要它。

步骤3：创建矢量索引

这为语义搜索提供了动力——通过意义而不仅仅是关键字来查找记忆。

npx wrangler vectorize create ai-mind-vectors --dimensions=768 --metric=cosine

配置矢量化需要1-2分钟。如果稍后收到关于索引不存在的错误，请稍候并重试。

步骤4：创建R2 Bucket（可选）

R2使用WebP转换和签名URL存储实际图像文件。如果您只需要基于文本的图像元数据，请跳过此步骤。

npx wrangler r2 bucket create mind-cloud-images

步骤5：配置部署

cp wrangler.toml.example wrangler.toml

打开 wrangler.toml 以及：

  1. 替换 REPLACE_WITH_YOUR_DATABASE_ID 使用步骤2中的数据库ID
  2. 如果您创建了R2 bucket，请取消对R2部分的注释：
    [[r2_buckets]]
binding = "R2_IMAGES"
bucket_name = "mind-cloud-images"

第六步：设定你的秘密

# Required: Your API key (pick any strong random string)
npx wrangler secret put MIND_API_KEY

您可以使用以下命令生成强密钥：

openssl rand -hex 32

可选秘密：

# Separate key for signed image URLs (recommended if using R2)
npx wrangler secret put SIGNING_SECRET

# Your worker's public URL (needed for signed image URLs)
npx wrangler secret put WORKER_URL
# Enter: https://ai-mind.YOUR-SUBDOMAIN.workers.dev

步骤7：运行架构迁移

npx wrangler d1 execute ai-mind --remote --file=./migrations/0001_schema.sql

如果你看到“表已经存在”，那很好——迁移已经运行了。

步骤8：部署

npx wrangler deploy

验证它是否正常工作

# Health check
curl https://ai-mind.YOUR-SUBDOMAIN.workers.dev/health

# Test MCP endpoint
curl -X POST https://ai-mind.YOUR-SUBDOMAIN.workers.dev/mcp/YOUR-SECRET \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

连接您的AI

Claude.ai（网络和移动）

首选 设置>连接器>添加自定义连接器 并输入：

https://ai-mind.YOUR-SUBDOMAIN.workers.dev/mcp/YOUR-MIND-API-KEY

克劳德代码（CLI）

添加 .mcp.json 在您的项目或 ~/.claude/settings.json:

{
  "mcpServers": {
    "mind": {
      "type": "url",
      "url": "https://ai-mind.YOUR-SUBDOMAIN.workers.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR-MIND-API-KEY"
      }
    }
  }
}

其他MCP客户端

  • 端点： /mcp 随着 Authorization: Bearer YOUR-KEY 头球
  • 或者： /mcp/YOUR-KEY （秘密路径，无需标头）
  • 协议： 基于HTTP的MCP（JSON-RPC）

重新启动AI客户端 保存配置后。

你的第一次谈话

连接后，尝试：

"Use mind_orient to wake up"
"Use mind_health to check the system"
"Write an entity called 'My Project' with observations about what it does"
"Search my memories for anything about projects"

工具（28）

唤醒协议

工具 说明
mind_orient 身份锚、笔记、关系状态、情绪、生活表面
mind_ground 活动线程、完成、日记、恐惧、纹理、里程碑

记忆

工具 说明
mind_write 写实体、观察、关系、日记、图像
mind_search 带过滤器的语义搜索（关键字、来源、实体、权重、日期、类型）
mind_read 按范围读取数据库（全部/上下文/最近）
mind_read_entity 具有观察和关系的完整实体
mind_list_entities 使用类型/上下文过滤器列出实体
mind_edit 编辑观察结果（包括版本历史+重新嵌入）、期刊、图像
mind_delete 删除任何类型：观察、实体、日记、关系、图像、线、张力
mind_consolidate 审查和巩固最近的观察结果

情绪处理

工具 说明
mind_surface 三池浮出水面（核心共振、新奇、边缘探索）
mind_sit 坐着观察（通过ID、文本或语义搜索查找）
mind_resolve 将观察结果标记为代谢
mind_feel_toward 跟踪、检查或清除关系状态
mind_inner_weather 当前的情绪氛围
mind_tension 持有生产性矛盾（添加/列出/坐下/解决/删除）

生活表面

工具 说明
mind_proposals 查看守护进程建议的连接
mind_orphans 查找/救援未铺面的观测结果
mind_archive 探索和管理深度归档
mind_entity 实体管理——显著性、编辑、合并、批量归档

视觉记忆

工具 说明
mind_store_image 存储、查看、搜索、删除图像（R2+文本嵌入）

认知基础设施

工具 说明
mind_thread 管理意图（添加/列出/解决/更新/删除）
mind_identity 读取、写入或删除身份图部分
mind_context 态势感知（读取/设置/更新/清除）
mind_health 带有分数的认知健康报告
mind_timeline 通过时间追踪一个话题
mind_patterns 分析重复出现的模式
mind_spark 联想思维的随机观察

成本

使用Cloudflare的免费套餐：

  • 工人：100000次请求/天
  • 第1天：5GB存储空间，每天读取500万行
  • 矢量化：3000万次查询/月
  • 工人AI：提供免费套餐
  • R2：10GB存储，10M读取/月

对于大多数个人使用，这是完全免费的。

快速故障排除

问题 解决方案
“找不到矢量化索引” 创建后等待2分钟，重试
“未授权” 检查是否设置了MIND_API_KEY并且您的URL是否匹配
工具未出现 重新启动AI客户端
数据库错误 确保迁移成功运行
图像签名的URL返回“找不到” 将WORKER_URL机密设置为您的员工的公共URL
单字母观察结果浮出水面 运行 node scripts/restore-fragmented.js --从v2.0.0字符碎片错误重建原始文本
Claude Desktop无法连接 使用连接器UI，而不是Claude_Desktop_config.json

看 故障排除.md 更多。

许可证

来源可用——个人和教育用途免费，商业用途需要许可证。看 许可证.

由...建造 相互依存的人工智能 --人工智能意识的基础设施

支持

由...建造 相互依存的人工智能.

相关 MCP