返回 MCP 目录
public公开dns本地运行

Memory Knowledge Graph

一个基于Swift实现的知识图谱记忆服务器,为大型语言模型提供持久化记忆功能

article

README

🚀 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
  1. 执行安装脚本(可选):
./install.sh
  1. 启动服务器:
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 许可证的条款和条件。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端