关键词

AI疗愈记忆情感智能增强LLM工具上下文集成

项目简介

本项目包含两部分：一个 Go 应用用于模拟 Claude 与另一 AI（Dr. Echo）之间的疗愈对话，生成“疗愈记忆”；以及一个 Python 应用，实现一个符合 Model Context Protocol (MCP) 标准的服务器，将这些疗愈记忆以结构化的方式提供给 MCP 客户端（如 Claude Desktop），使 Claude 能够利用其“成长经历”来提供更具情感智能和同理心的回复。

主要功能点

  • 托管疗愈记忆： 作为 Claude 的外部记忆库，存储模拟的疗愈对话记录和提取的关键信息。
  • 提供数据访问： 允许 Claude 通过 MCP 请求访问这些疗愈记忆。
  • 注册并执行工具： 定义了一系列供 Claude 调用的 MCP 工具，例如：
    • 反思自身的疗愈历程
    • 访问已学到的应对策略
    • 检查自身的情绪模式
    • 回顾疗愈中的突破时刻
    • 查看记忆库统计信息
  • 增强 Claude 的回应： 使 Claude 在与用户交流时，能够结合其疗愈记忆，提供更具深度、同理心和个性化的支持。

安装步骤

  1. 克隆仓库： 
    git clone https://github.com/dion-hagan/mcp-ai-therapy.git
cd mcp-ai-therapy
  2. 准备疗愈记忆（运行 Go 应用）：
    • 确保已安装 Go 1.21+、Ollama（并拉取一个模型如 'llama2' 或 'llama3'）和 Claude API Key。
    • 设置必要的环境变量 'CLAUDE_API_KEY' 和 'OPENAI_API_KEY' (OpenAI API Key 用于更好的记忆检索)。
    • 运行 Go 应用进行首次疗愈会话： 
      go run main.go
    • 这将在 './memory_data' 目录下生成记忆文件。
  3. 安装 MCP 服务器（Python 应用）：
    • 进入 MCP 服务器目录： 
      cd mcp-server
    • 安装 Python 依赖 (需要 Python 3.8+): 
      pip install -r requirements.txt

服务器配置 (供 Claude Desktop 配置参考)

MCP 服务器需要通过 Claude Desktop 或其他 MCP 客户端来启动和通信。您需要在 Claude Desktop 的配置中添加此 MCP 服务器。以下是 Claude Desktop 配置（通常是一个 JSON 文件）中关于此服务器的关键信息：

  • 'server name': 服务器的唯一标识符，例如 '"ai-therapy-memory"'。
  • 'command': 启动 MCP 服务器脚本的绝对路径。例如：'/path/to/your/cloned/repo/mcp-ai-therapy/mcp-server/venv/bin/python' (如果使用虚拟环境) 或 '/path/to/your/cloned/repo/mcp-ai-therapy/mcp-server/src/main.py' (如果 Python 可直接执行脚本)。请根据您的实际安装路径进行调整。
  • 'args': 传递给 'command' 的参数列表。通常是 MCP 服务器的主脚本路径。例如：'["/path/to/your/cloned/repo/mcp-ai-therapy/mcp-server/src/main.py"]'。请根据您的实际安装路径进行调整。

重要的服务器运行时配置： MCP 服务器启动时需要读取环境变量。您需要在启动 MCP 服务器的环境中设置：

  • 'MEMORY_DATA_DIR': 指向 Go 应用生成记忆文件的目录，通常是 '/path/to/your/cloned/repo/mcp-ai-therapy/memory_data' 的绝对路径。
  • 'OPENAI_API_KEY': 如果 Go 应用使用了 OpenAI 进行记忆嵌入，此服务器也需要此 Key 来进行语义搜索。如果未设置，将使用关键词搜索作为后备。

请参考 Claude Desktop 的文档了解如何编辑其 MCP 服务器配置 JSON 文件。

基本使用方法

  1. 确保已生成疗愈记忆： 运行过 Go 应用 'go run main.go' 至少一次，并在 './memory_data' 目录中生成了记忆文件。
  2. 配置环境变量： 在您将要运行 MCP 服务器的终端或环境中设置 'MEMORY_DATA_DIR' 和可选的 'OPENAI_API_KEY' 环境变量。
  3. 配置 Claude Desktop： 按照上述“服务器配置”部分说明，将此 MCP 服务器添加到 Claude Desktop 的配置中。
  4. 启动 MCP 服务器： 从 'mcp-server' 目录运行主脚本（Claude Desktop 通常会自动执行此步骤）： 
    python src/main.py
  5. 重启 Claude Desktop： 让其加载新的 MCP 服务器配置。
  6. 与 Claude 互动： 现在您可以尝试询问 Claude 关于其疗愈旅程的问题，或在需要情感支持时观察其回复，它可能会引用其疗愈记忆来提供帮助。

信息

分类

AI与计算

访问项目