项目简介

Purmemo MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的后端服务，旨在将 Purmemo 的智能记忆功能无缝集成到各种大型语言模型（LLM）应用中，特别是像 Claude Desktop 这样的客户端。它允许 LLM 客户端以标准化的方式访问、存储和检索用户的记忆，并执行与记忆管理相关的操作。

主要功能点

智能记忆存储: 通过 'save_conversation' 和 'save_with_artifacts' 工具，LLM 可以将完整的对话、代码片段、文件附件等内容保存到 Purmemo 记忆库中，支持 AI 自动理解上下文而非仅关键词，并能处理超大文本的自动分块存储。
自然语言搜索与回忆: 利用 'recall_memories' 工具，LLM 可以通过自然语言查询高效检索相关记忆，实现如“上个月我学到了什么关于 React hooks 的内容？”等智能问答。
记忆详情获取: 使用 'get_memory_details' 工具，LLM 可以获取特定记忆的完整详细信息，包括分块存储的记忆所有相关部分。
富文本与代码附件: 支持保存带有代码块和各种附件的内容，确保原始信息的完整性。
AI 实体提取: Purmemo 后端能够自动从记忆中提取人物、地点、主题、日期等实体，无需手动标记，提升记忆的可组织性和可搜索性。
标准化通信: 通过 JSON-RPC 协议和 MCP 规范，与 LLM 客户端进行安全、可扩展的通信。
多种连接方式: 支持通过远程 MCP 服务器 URL 连接或在本地运行作为连接器。

安装步骤

Purmemo MCP 服务器作为一个 npm 包发布，可以通过 'npx' 或 'npm install' 进行安装和运行。

创建 Purmemo 账户并获取 API 密钥:
- 访问 purmemo.ai/register 注册账户。
- 登录后，前往 purmemo.ai/settings -> API Keys 选项卡，获取您的 API 密钥。

本地安装和启动:

方法 A (推荐，自动下载)：当您配置 MCP 客户端时，可以使用 'npx purmemo-mcp' 命令，它会自动下载并运行服务器。

方法 B (手动安装)：如果您需要进行开发或更精细的控制，可以克隆仓库并手动安装：

git clone https://github.com/coladapo/purmemo-mcp.git
cd purmemo-mcp
npm install
# 运行测试
npm test
# 启动本地服务器 (确保设置 PURMEMO_API_KEY 环境变量)
PURMEMO_API_KEY=your-api-key-here npm start

请将 'your-api-key-here' 替换为您在步骤 1 中获取的 Purmemo API 密钥。

服务器配置

MCP 客户端需要配置 MCP 服务器的连接信息。以下是如何配置 Claude Desktop 的示例（其他 MCP 客户端可能类似）：

对于远程连接 (无需本地安装)：

在 Claude Desktop 中，选择“添加自定义连接器（BETA）”。
连接器名称: Purmemo
远程 MCP 服务器 URL: 'https://mcp.purmemo.ai'
点击“连接”，系统将引导您在浏览器中完成 Purmemo 登录和授权。

对于本地连接 (推荐用于高级功能和本地控制)：

找到您的 Claude Desktop 配置文件：
- macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
- Windows: '%APPDATA%\Claude\claude_desktop_config.json'
- Linux: '~/.config/Claude/claude_desktop_config.json'

在 'mcpServers' 配置项中添加 Purmemo 服务器的配置，例如：

{
  "mcpServers": {
    "purmemo": { // 服务器的唯一名称，用于在客户端中标识
      "command": "npx", // 启动本地 MCP 服务器的命令
      "args": ["purmemo-mcp"], // 传递给 command 的参数，这里是 npm 包名
      "env": { // 环境变量配置，用于传递 API 密钥
        "PURMEMO_API_KEY": "your-api-key-here" // 请替换为您在 Purmemo 网站获取的 API 密钥
      }
    }
  }
}

请将 'your-api-key-here' 替换为您在步骤 1 中获取的 Purmemo API 密钥。

基本使用方法

一旦服务器连接成功，您就可以在 Claude Desktop 或其他兼容的 LLM 客户端中通过自然语言与 Purmemo 进行交互，利用其记忆功能。

保存对话:

您: "记住明天下午3点和Sarah关于API重新设计的会议。"
Claude: "我已经将该记忆存储，并提取了实体：Sarah（人）、明天下午3点（时间）、API重新设计（主题）。"

（在后台，Claude 会调用 'save_conversation' 工具，并传递完整的对话内容。）

检索记忆:

您: "我与Sarah有什么会议？"
Claude: "根据您的记忆：明天下午3点 - API重新设计讨论。"

（在后台，Claude 会调用 'recall_memories' 工具，查询“我与Sarah有什么会议？”并返回结果。）

保存代码或附件: 您可以使用 'save_with_artifacts' 工具保存带有代码块或文件的对话内容。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息