C.W.K. Pippa MCP Memory Manager for Cursor IDE

基本能力

产品定位

C.W.K. Pippa MCP Memory Manager 是一个为 Cursor IDE 设计的记忆管理系统，旨在通过 MCP 协议为 AI 助手提供持久的记忆能力。

核心功能

• Remember: 存储重要信息以供未来检索
• Recall: 基于语义搜索检索记忆
• Browse: 查看和管理所有存储的记忆
• Edit/Delete: 修改或删除现有记忆
• Configuration: 自定义嵌入模型、日志级别等

适用场景

• 需要 AI 助手在多个会话中保持记忆的开发场景
• 需要管理大量记忆信息的 AI 应用
• 学习和理解 MCP 协议的实践项目

工具列表

• mcp_remember: 存储记忆
• mcp_recall: 检索记忆
• mcp_list: 列出所有记忆
• mcp_delete: 删除记忆
• mcp_config: 配置系统

常见问题解答

• MCP 工具调用: 必须使用明确的工具调用语法，如 "use the mcp_list tool"
• Python 环境问题: 确保在 Cursor 使用的 Python 环境中安装包
• API 密钥: 需要在 .env 和 mcp.json 中配置 OpenAI API 密钥

使用教程

使用依赖

• Python 3.8+
• Cursor IDE
• OpenAI API key

安装教程

1. 克隆仓库:

git clone https://github.com/neobundy/cwkCursorPippaMCP.git
cd cwkCursorPippaMCP

1. 安装依赖:

pip install -r requirements.txt

1. 安装开发模式包:

cd mcp-pippa-memory
pip install -e .

1. 创建 .env 文件并配置 OpenAI API 密钥:

OPENAI_API_KEY=your_api_key_here

1. 创建 mcp.json 配置文件:

{
  "version": 1,
  "mcpServers": {
    "pippa-memory": {
      "command": "python",
      "args": [
        "-m",
        "mcp_pippa_memory"
      ],
      "env": {
        "OPENAI_API_KEY": "your_openai_api_key_here"
      }
    }
  }
}

调试方式

1. 在 Cursor IDE 的 MCP 设置中启用 "pippa-memory"
2. 使用 Streamlit UI 管理记忆:

cd mcp-pippa-memory
streamlit run streamlit_app.py

1. 使用 API 进行程序化记忆管理:

from mcp_pippa_memory.memory import PippaMemoryTool
memory_tool = PippaMemoryTool()
memory_tool.remember("Important information")
results = memory_tool.recall("What was that important information?")

许可证

该项目遵循 MIT 开源许可条款。