AI导哈

代码会话记忆系统

为Claude Code会话提供结构化记忆系统，通过MCP服务器和CLI记录任务上下文、决策、文件变更和分支操作，支持会话恢复和漂移检测。

  • by amragl
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 amragl/claude-code-helper-mcp

使用说明

claude代码助手mcp

Claude Code会话的结构化存储系统。提供MCP服务器和CLI，用于在开发过程中记录任务上下文、决策、文件更改和分支操作，从而在以下情况下实现恢复 /clear 以及跨会话的漂移检测。

特性

  • 任务记忆 --记录每个任务的步骤、决策、文件修改和分支操作
  • 滑动窗口 --保留当前任务和3个最近任务的上下文
  • MCP服务器 --基于FastMCP的透明内存记录工具
  • 恢复上下文 --完整任务上下文恢复后 /clear
  • 漂移检测 --识别错误循环、范围蔓延和计划漂移
  • 命令行界面 --面向开发人员的内存检查和管理命令
  • Agent Forge集成 --通过管道挂钩自动记录

安装

pip install -e .

发展：

pip install -e ".[dev]"

用法

命令行界面

# Show version
memory --version

# Show help
memory --help

MCP服务器

MCP服务器注册为 claude-code-helper 并通过stdio传输进行通信。在Claude Code MCP设置中配置它。

项目结构

src/claude_code_helper_mcp/
    __init__.py          # Package init with version
    models/              # Pydantic data models
    storage/             # File-based storage engine
    mcp/                 # FastMCP server and tools
    cli/                 # Click CLI commands
    detection/           # Drift and confusion detection
    hooks/               # Agent Forge hook integration
tests/                   # Test suite

发展

# Run tests
pytest tests/

# Run CLI directly
python -m claude_code_helper_mcp.cli.main --help

存储

任务内存将持久化到 .claude-memory/ 每个项目中的目录。每个任务都有自己的JSON文件，其中包含步骤、决策、文件记录和分支记录。

许可证

麻省理工学院

相关 MCP