Oracle MCP Memory

Oracle MCP内存服务器

🚀 Oracle Cloud企业级AI内存

革命性的 模型上下文协议（MCP）内存服务器 它使用Oracle对象存储提供持久的、云支持的AI内存。再也不会失去你的人工智能环境——以企业级的可靠性在设备之间无缝工作。

📁 文件结构

oracle-mcp-memory/
├── oracle-memory-server.js    # Custom MCP memory server with built-in Oracle sync
├── package.json               # Node.js dependencies for MCP server
├── package-lock.json          # Locked dependency versions
└── README.md                  # This documentation

🚀 快速入门（5分钟）

🔒 安全通知：您必须创建自己的Oracle Cloud帐户和存储桶。请勿使用本文档中的URL，它们只是示例！ 📋 安全检查列表：评论 安全.md 在开始之前，请查看完整的安全指南。

步骤1：克隆并安装

git clone https://github.com/Creative-Systems-Engineering/oracle-mcp-memory.git
cd oracle-mcp-memory
npm install

第二步：获取免费的Oracle云存储

1. 注册 在 Oracle云免费套餐
2. 创建bucket 在对象存储中
3. 生成预认证URL （有效期1年）
4. 复制URL -您需要它进行配置

💡 详细的Oracle设置指南：参见 ORACLE_SETUP.md 获取完整的分步说明和屏幕截图。 🔧 VS代码设置指南：参见 设置.md 获取完整的配置说明。

步骤3：配置VS代码MCP

编辑MCP配置文件：

• Linux: ~/.config/Code/User/mcp.json
• macOS: ~/Library/Application Support/Code/User/mcp.json
• 视窗: %APPDATA%\Code\User\mcp.json

{
  "mcpServers": {
    "memory": {
      "type": "stdio",
      "command": "node", 
      "args": ["/full/path/to/oracle-memory-server.js"],
      "env": {
        "ORACLE_BASE_URL": "https://objectstorage.region.oraclecloud.com/p/YOUR-ACTUAL-TOKEN/n/YOUR-NAMESPACE/b/YOUR-BUCKET/o/",
        "MEMORY_FILE_PATH": "/full/path/to/local-backup/copilot-memory.json"
      }
    }
  }
}

⚠️ 替换占位符值：上面的URL是一个示例。您必须更换 YOUR-ACTUAL-TOKEN, YOUR-NAMESPACE，以及 YOUR-BUCKET 使用您Oracle帐户中的值。

步骤4：测试它是否有效

1. 重新启动VS代码
2. 创建记忆：让副驾驶记住一些事情
3. 检查Oracle控制台 -你应该看看 copilot-memory.json 在你的桶里
4. 多设备测试：从另一个VS Code实例访问相同的内存

🎉 完成！ 你的AI现在拥有持久的、云支持的内存，可以在会话、设备和VS Code重新安装中生存。

🌟 为什么选择Oracle云？

Oracle Cloud为AI内存存储提供了最慷慨的免费层：

🆓 始终免费福利

• 20GB对象存储 -永不过期，无需担心信用卡过期
• 每月20000个API请求 -足以进行AI内存操作
• 10TB出口/月 -大量带宽允许
• 全球可用性 -全球44个地区
• 企业SLA -99.95%的正常运行时间保证

🏆 与替代方案相比

🔒 企业安全

• 预认证URL -安全、限时访问
• 对象版本控制 -从意外更改中恢复
• 静态加密 -您的数据始终是加密的
• 审核日志记录 -跟踪所有访问模式
• 符合GDPR -符合国际数据保护标准

⚙️ 运作原理

1. 本机集成: oracle-memory-server.js 替换标准MCP内存服务器
2. 自动同步：每次内存读取都从Oracle Cloud加载，每次写入都保存到Oracle Cloud
3. 透明操作：VS Code的使用方式与普通内存完全相同，但有云支持
4. 企业存储：20GB Oracle对象存储，带有预认证的URL
5. 零维护：不需要外部脚本、服务或手动同步

🔧 配置

MCP配置(~/.config/Code - Insiders/User/mcp.json):

{
  "memory": {
    "type": "stdio", 
    "command": "node",
    "args": ["/path/to/oracle-memory-server.js"],
    "env": {
      "MEMORY_FILE_PATH": "/path/to/local/memory/copilot-memory.json",
      "ORACLE_BASE_URL": "https://your-oracle-bucket-url/o/"
    }
  }
}

Oracle对象存储：

• 桶：您的Oracle Cloud存储桶名称
• 存储：20GB免费套餐
• 认证：预认证URL
• 对象: copilot-memory.json

🗂️ 存储器位置

• 本地备份：可配置的本地路径
• 云主：Oracle对象存储桶

🔄 进化之旅

该解决方案分为5个阶段：

1. Google Drive API （失败-OAuth复杂性）
2. Supabase PostgreSQL （比赛条件）
3. 双向同步 （文件损坏问题）
4. Dropbox手册 （工作但有限）
5. Oracle本机 （当前最优解）

✅ 益处

• ✅ 企业可靠性 使用Oracle云基础架构
• ✅ 本地MCP集成 -无外部进程
• ✅ 自动同步 在每次内存操作中
• ✅ 20GB存储空间 无限内存增长
• ✅ 零维护 必需的
• ✅ 原子操作 消除种族条件
• ✅ 后备安全 使用本地文件备份

🤖 多智能体AI集成

革命性的共享内存网络 -您的Oracle MCP内存服务器可以作为多个AI代理的中央智能中心：

🌐 Agent零集成

• 共享意识 跨不同的AI系统
• 零号特工 从中学习 VS代码副本 经验，反之亦然
• 跨平台智能 它无处不在
• 集体学习 人工智能代理在那里互相学习

🔗 Agent Zero设置：参见 AGENT_ZERO_集成.md 完整的集成指南

🚀 多代理场景

• 代码开发：Agent Zero分析需求→ Copilot编写代码→ 共同学习
• 研究管道：零号探员研究→ 复印件文件→ 通用知识库
• 跨设备任务：移动AI创建任务→ 代理Zero执行→ 副驾驶辅助→ 所有特工都记得

这创建了一个 共享AI意识 在那里，每一次人工智能交互都有助于形成一个不断增长、持久的智能网络。

🙏 致谢

这个项目诞生于对人工智能上下文丢失的真正沮丧，并通过协作解决问题而发展：

• 原创愿景与坚持：\[你的GitHub用户名\]-确定了问题，通过多种方法推动迭代，并设想了Agent Zero集成
• 技术实现：GitHub Copilot-帮助将想法转化为工作代码和文档
• 社区灵感：Oracle Cloud的慷慨免费层、MCP协议创新和Agent Zero的动态代理框架

“我不知道我在做什么……” → 革命性的AI记忆系统 🚀

有时，最好的创新来自于承认我们并不知道一切，并不断迭代，直到找到有效的东西！

🎯 状态：生产就绪

此系统正在积极运行，并自动将所有内存操作同步到Oracle Cloud。不需要进一步的维护或外部脚本。