AI导哈

个人记忆存储服务

一个本地化的个人记忆存储与检索服务，用于存储和检索个人信息、偏好、记忆、关系和目标。

  • by Joopsnijder
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Joopsnijder/personal-memory-mcp

使用说明

个人存储器MCP服务器

现代MCP（模型上下文协议）服务器，为Claude Desktop提供在本地存储和检索个人信息的能力。

特性

  • 个人信息：存储和检索基本个人信息
  • 偏好设置：按类别（食物、音乐、工作等）组织偏好
  • 回忆：使用标签和上下文存储记忆，便于搜索
  • 关系：跟踪您认识的人的信息
  • 目标：通过状态跟踪管理个人和职业目标
  • 本地存储：所有数据都安全地存储在本地JSON文件中

快速开始

先决条件

  • Python 3.10或更高版本
  • 紫外线 包管理器

安装

  1. 克隆或下载此项目
  2. 如果您还没有安装uv：
   curl -LsSf https://astral.sh/uv/install.sh | sh
  1. 设置项目：
   cd personal-memory-mcp
   uv sync

配置

将此添加到您的Claude Desktop配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

视窗: %APPDATA%/Claude/claude_desktop_config.json

Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "personal-memory": {
      "command": "uv",
      "args": ["run", "memory-server"],
      "cwd": "/path/to/personal-memory-mcp"
    }
  }
}

替换 /path/to/personal-memory-mcp 带有项目目录的实际路径。

用法

配置后，重新启动Claude Desktop。然后，您可以使用自然语言与您的记忆进行交互：

  • “记住，我最喜欢的咖啡是卡布奇诺”
  • “我在会议上认识Sarah的商店——她是一名数据科学家”
  • “增加一个目标，在年底前学习西班牙语”
  • “你还记得我对食物的偏好吗？”
  • “显示我的活动目标”

测试服务器

您可以使用MCP检查器测试服务器功能：

uv run mcp dev server.py

发展

运行测试

uv run pytest

代码格式化

uv run black .
uv run ruff check .

直接运行服务器

uv run python memory_server.py

数据存储

所有个人数据都存储在本地 personal_memory.json 在项目目录中。该文件包括：

  • 个人信息（姓名、位置等）
  • 分类偏好
  • 带有标签的带时间戳的记忆
  • 关系信息
  • 具有状态跟踪功能的目标

隐私和安全

  • 仅限本地：所有数据都保留在您的机器上
  • 没有网络：没有数据传输到外部服务器
  • 完全控制：您拥有并控制所有数据
  • 备份友好：简单的JSON格式，便于备份

许可证

MIT许可证-有关详细信息，请参阅许可证文件。

相关 MCP