AI导哈

代码记忆服务

CCMem是一个标准化的MCP服务器，为Claude Code提供持久化的项目记忆和上下文感知的开发辅助，将Claude Code从无状态助手转变为项目感知的开发伙伴。

  • by adestefa
  • JavaScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 adestefa/ccmem

使用说明

CCMem-克劳德代码存储器

一个标准化的MCP服务器，为Claude Code提供持久的项目内存和上下文感知的开发帮助。

概述

CCMem（Claude Code Memory）通过跨会话维护持久内存，将Claude Code从无状态助手转变为项目感知开发合作伙伴。该系统捕获并存储项目上下文、架构决策、开发历史和积累的知识。

主要特点

  • 项目设置管理：存储和调用启动、测试、构建和部署命令
  • 架构文档：维护技术栈决策、模式和设计选择
  • 发展历程：跟踪故事、任务、错误和经验教训
  • 知识积累：随着时间的推移，建立背景和见解
  • 零代币成本：使用本地SQLite数据库，而不是昂贵的嵌入服务
  • 自动捕获：智能挂钩无缝捕捉开发活动

安装

方法1:NPM包（推荐）

在NPM中使用Claude的内置MCP管理器：

claude mcp add ccmem -- npx -y @adestefa/ccmem@latest

自动设置：

  • 配置Claude Code MCP集成
  • 设置内存捕获挂钩
  • 立即准备使用

方法2：直接GitHub（最新）

直接从GitHub仓库安装：

claude mcp add ccmem -- uvx --from git+https://github.com/adestefa/ccmem ccmem-server

优点：

  • 始终使用最新代码
  • 无NPM注册表依赖关系
  • 非常适合开发和测试

方法3：传统安装

NPM全球安装

npm install -g @adestefa/ccmem
cd /path/to/your/project
ccmem setup

直接安装脚本

curl -fsSL https://raw.githubusercontent.com/adestefa/ccmem/main/install.sh | bash

手动安装

git clone https://github.com/adestefa/ccmem.git
cd ccmem
npm install -g .
ccmem setup

配置

自动配置

使用时 claude mcp add，配置将自动处理。该系统将：

  1. 安装MCP服务器
  2. 配置Claude代码集成
  3. 设置自动内存捕获挂钩
  4. 首次使用时初始化项目数据库

手动配置

如果手动安装，请添加到 ~/.claude/mcp_servers.json:

{
  "mcpServers": {
    "ccmem": {
      "command": "npx",
      "args": ["-y", "@adestefa/ccmem@latest"],
      "description": "Project memory system for Claude Code"
    }
  }
}

用法

命令行接口

CCMem为项目内存管理提供了一个全面的CLI：

# Initialize memory system in current project
ccmem setup

# View project status and memory
ccmem status

# Search project memory
ccmem search "authentication"

# Get project context
ccmem context

# Learn project settings
ccmem learn setting start command "npm start"
ccmem learn architecture "API Server" "REST API using Express" "Node.js,Express,PostgreSQL"

可用命令

  • ccmem setup -在当前项目中初始化CCMem
  • ccmem status -显示项目状态和内存摘要
  • ccmem search <query> -在所有项目内存中搜索
  • ccmem context [focus] -获取项目上下文（全部、设置、架构、当前、最近）
  • ccmem learn setting <category> <key> <value> -存储项目配置
  • ccmem learn architecture <component> <description> <tech> -记录架构决策

与Claude Code集成

安装后，CCMem与Claude Code一起透明运行：

  1. 会话初始化：Claude启动时自动加载项目上下文
  2. 积极发展：捕获文件修改、命令执行和架构见解
  3. 知识建构：提取和存储开发模式和决策
  4. 上下文提供：当Claude需要项目信息时提供相关内存

建筑

数据库模式

CCMem使用具有以下核心表的本地SQLite数据库：

  • 设置 -项目配置和命令
  • 建筑 -系统设计和技术决策
  • 部署 -发布和部署程序
  • 故事 -用户故事和功能开发
  • 任务 -开发任务和实施说明
  • 缺陷 -Bug报告和修复
  • 课程 -架构决策和学习
  • 知识 -项目总体背景和说明

内存捕获系统

该系统包括智能挂钩，可自动捕捉：

  • 文件操作：重大代码修改及其背景
  • 命令执行：生成、测试和部署命令
  • 建筑见解：从克劳德的答复中提取的技术决定
  • 发展里程碑：会议总结和进度标记

数据存储

  • 位置: .claude/db/ccmem.sqlite 在每个项目目录中
  • 隔离：每个项目都维护自己的独立数据库
  • 演出：通过索引和准备好的报表进行优化
  • 可移植性：标准SQLite格式，便于备份和迁移

MCP工具

CCMem为Claude Code提供了以下MCP工具：

学习工具

  • ccmem_learn_setting -存储项目配置
  • ccmem_learn_architecture -文档系统架构
  • ccmem_learn_deployment -记录部署程序

发展跟踪

  • ccmem_create_story -创建用户故事
  • ccmem_create_task -跟踪开发任务
  • ccmem_log_defect -记录错误和修复

知识管理

  • ccmem_record_lesson -吸取经验教训
  • ccmem_add_knowledge -存储一般项目知识
  • ccmem_get_context -检索项目上下文
  • ccmem_search -搜索项目内存

发展模式

绿色模式（积极发展）

在主动开发过程中，CCMem会自动：

  • 捕获文件修改及其意义
  • 记录命令执行及其结果
  • 从Claude的回应中提取建筑见解
  • 记录发展里程碑和会议总结

棕色模式（探索）

在探索现有项目时，CCMem：

  • 发现项目结构和技术的文件
  • 映射配置文件及其用途
  • 捕获现有的工作流程和开发模式
  • 确定未来调查的知识差距

益处

对于个人开发者

  • 连续性：在发展会议期间保持背景
  • 学习：建立关于项目的机构知识
  • 效率：无需重新解释项目背景

对于开发团队

  • 入职：为新团队成员提供即时项目上下文
  • 知识共享：集中架构决策和模式
  • 一致性：跨项目标准化开发方法

克劳德代码

  • 情境感知：了解项目历史和决策
  • 智能辅助：提供针对具体项目的相关指导
  • 减少重复：消除每次会议重新建立背景的需要

需求

系统相关性

选项1：面包（推荐）

  • 安装： curl -fsSL https://bun.sh/install | bash
  • 优点：原生SQLite支持，性能更快，零外部依赖
  • 平台：macOS、Linux、Windows（WSL）

选项2:Node.js（回退）

  • 版本：Node.js 18.0.0或更高版本
  • 安装： nodejs.org 或 brew install node
  • 注意：为了兼容性，使用JSON存储而不是SQLite

选项3:UV/UVX（适用于直接GitHub）

  • 安装： brew install uv （macOS）或 winget install --id=astral-sh.uv （Windows）
  • 用例：直接安装GitHub存储库

Claude代码要求

  • 支持MCP的Claude代码
  • 正确的MCP服务器配置（自动 claude mcp add)

许可证

MIT许可证-有关详细信息，请参阅许可证文件。

贡献

欢迎捐款。请参阅存储库以获取贡献指南。

支持

有关问题和支持，请使用GitHub问题跟踪器https://github.com/adestefa/ccmem/issues.

相关 MCP