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许可证-有关详细信息，请参阅许可证文件。