codebase-memory-mcp：代码库记忆MCP服务完整教程

GitHub：codebase-memory-mcp ⭐ 36K+ | TypeScript | MIT License

项目简介

codebase-memory-mcp 是一个基于 MCP（Model Context Protocol）的代码库记忆服务，解决的核心问题是：AI编程助手每次对话都"失忆"，不记得你的项目结构、编码风格和历史决策。它作为 MCP Server 运行，可以为 Claude Code、Cursor、Windsurf 等支持 MCP 的客户端提供项目级长期记忆，让AI助手真正"理解"你的代码库。

安装

# npm 全局安装
npm install -g codebase-memory-mcp

# 或项目级安装
npm install --save-dev codebase-memory-mcp

# 初始化代码库记忆
npx codebase-memory init --project ./my-project

# 启动MCP服务
npx codebase-memory serve --port 3001

核心功能

快速使用

// Claude Code 配置 (.claude/mcp.json)
{
  "mcpServers": {
    "codebase-memory": {
      "command": "npx",
      "args": ["codebase-memory-mcp", "serve"],
      "env": {
        "PROJECT_ROOT": "/path/to/my-project",
        "STORAGE_PATH": "./.codebase-memory"
      }
    }
  }
}

// 在Cursor中配置
// Settings → MCP → Add Server
// Command: npx codebase-memory-mcp serve
// Env: PROJECT_ROOT=./

// 使用示例：让AI记住架构决策
// 在对话中说：
// "记住：我们选择PostgreSQL而不是MongoDB，
//  因为事务一致性对金融场景至关重要"

// MCP会自动存储这条决策，后续对话中
// AI会自动参考该决策给出一致的建议

如果你正在使用 Claude Code 作为主力编程助手，搭配 Claude-Mem记忆插件 可以形成更完整的记忆体系——Claude-Mem负责会话级记忆，codebase-memory-mcp负责项目级记忆，两者互补让AI助手拥有跨会话、跨项目的持久记忆能力。

适用场景