Memory Knowledge Graph

🚀 Memory MCP 服务器

Memory MCP 服务器是一个用 Swift 实现的知识图谱内存服务器，专为 Model Context Protocol (MCP) 设计，能为大型语言模型提供持久化记忆功能。本项目以官方 TypeScript 实现为基础，借助 MCP Swift SDK 重写为 Swift 版本。

✨ 主要特性

• 快速响应：可高效处理内存操作请求。
• 持久存储：能将数据持久化到本地文件系统。
• 结构清晰：采用简单明了的知识图谱结构。
• 易于扩展：支持未来功能的扩展和优化。
• 兼容性好：可与 MCP 协议无缝集成。

📦 安装指南

系统要求

• Swift 6.0 或更高版本
• macOS 14.0 或更高版本
• MCP Swift SDK 0.2.0 或更高版本

安装步骤

1. 克隆项目仓库：

git clone https://github.com/okooo5km/memory-mcp-server.git
cd memory-mcp-server

2. 执行安装脚本（可选）：

./install.sh

3. 启动服务器：

swift run -- --port 8080

💻 使用示例

基础用法

创建实体

{
  "entities": [
    {
      "name": "John Smith",
      "entityType": "Person",
      "observations": ["软件工程师", "居住在旧金山", "喜欢远足"]
    },
    {
      "name": "Acme Corp",
      "entityType": "Company",
      "observations": ["成立于2010年", "科技初创公司"]
    }
  ]
}

创建关系

{
  "relations": [
    {
      "from": "John Smith",
      "to": "Acme Corp",
      "relationType": "工作于"
    }
  ]
}

添加观察

{
  "observations": [
    {
      "entityName": "John Smith",
      "contents": ["最近晋升为高级工程师", "正在从事人工智能项目"]
    }
  ]
}

搜索节点

{
  "query": "旧金山"
}

打开特定节点

{
  "names": ["John Smith", "Acme Corp"]
}

📚 详细文档

使用场景

• AI 助手的长期记忆：使 AI 助手能够记住用户的偏好、过去互动和重要事实。
• 知识管理：组织有关人、地点、事件和概念的信息。
• 关系跟踪：维护实体之间的关系网络。
• 上下文持久性：保存重要的上下文跨多个会话。
• 日记和日常记录：保持结构化的记录，按时间顺序轻松检索和关联过去的经验。

版本历史

查看 GitHub 发布页面获取版本历史和变更日志。

☕️ 支持项目

如果你发现 Memory MCP Server 有帮助，请考虑支持其开发：

• ⭐️ 在 GitHub 上为项目点星
• 🐛 报告错误或建议功能
• 💝 支持方式：

关于

该项目由 Okooo5km 开发，灵感来源于官方 TypeScript 实现，但在 Swift 中使用 MCP Swift SDK 重写。

📄 许可证

memory-mcp-server 使用 MIT 许可证。这意味着你可以自由使用、修改和分发软件，但需遵守 MIT 许可证的条款和条件。