Back to MCP directory
publicPublicdnsLocal runtime

cline-mcp-memory-bank

Cline Memory Bank是一个为AI辅助开发设计的持久化项目上下文管理服务器,通过与VSCode的Cline扩展集成,实现跨会话的项目记忆功能,包括上下文维护、进度跟踪和技术决策记录。

article

README

🚀 Cline 项目记忆银行

Cline 项目记忆银行是一个强大的工具,它能帮助开发者管理项目上下文、进度和决策信息。通过初始化记忆银行,开发者可以轻松跟踪项目的各个方面,提高项目管理效率。

🚀 快速开始

Cline 项目记忆银行使用简单,能帮助你高效管理项目信息。以下是快速开始的步骤:

  1. 安装依赖。
  2. 初始化记忆银行。
  3. 开始使用记忆银行管理项目。

📦 安装指南

步骤 1: 安装依赖

npm install cline-mcp

步骤 2: 初始化记忆银行

在你的项目根目录运行:

npx cline-mcp init

💻 使用示例

基础用法

初始化新记忆银行

useMCPTool('memory-bank', 'initialize_memory_bank', {
    projectPath: process.cwd() // 或指定路径
});

访问项目上下文

accessMCPResource('memory-bank', 'memory://project/context');

高级用法

加载上下文

accessMCPResource('memory-bank', 'memory://project/context');

更新当前上下文

useMCPTool('memory-bank', 'update_context', {
    projectPath: process.cwd(),
    content: {
        currentSession: {
            date: new Date().toISOString().split('T')[0],
            mode: 'development',
            task: '当前任务描述'
        }
    }
});

📚 详细文档

文件结构

初始化后,记忆银行会在项目根目录下创建以下文件:

.
├── memory-bank/
│   ├── projectContext.md
│   ├── activeContext.md
│   ├── progress.md
│   └── decisionLog.md

初始文件内容示例

activeContext.md

# 当前上下文

## 会话信息
- **日期**: YYYY-MM-DD
- **模式**: development
- **任务**: 初始化新项目

## 开放问题
1. 确定项目目标?
2. 明确需求优先级?

## 最近更新
- 初始化基本文件结构

progress.md

# 进度跟踪

## 当前阶段: 初始化
### 已完成任务
1. 仓库初始化
2. 基本结构创建

### 正在进行的任务
1. 环境配置
2. 文档编写

### 计划任务
- 安装依赖
- 配置开发环境

## 阻碍跟踪
无已知阻碍

decisionLog.md

# 决策日志

## 项目结构决策
- **决定**: 使用模块化结构
- **原因**: 提高代码可维护性
- **备选方案**: 单一文件组件

## 开发工作流选择
- **决定**: 采用 GitFlow 模型
- **原因**: 改善团队协作和版本控制
- **备选方案**: Feature Branch 流程

projectContext.md

# 项目上下文

## 项目概述
- **名称**: 新项目
- **版本**: 1.0.0

## 技术栈
### 前端
- React: ^18.2.0
- Redux: ^4.2.1

### 后端
- Node.js: ^16.14.2
- Express: ^4.18.2

## 配置文件
- .gitignore
- package.json
- README.md

系统提示建议

将以下内容添加到 Cline 的系统提示或 .clinerules 文件中:

记忆银行集成规则:

CRITICAL: 在执行任何任务之前:
1. 始终检查活跃上下文 (memory://active/context):
   - 当前项目状态和模式
   - 正在进行的任务及其状态
   - 最近的决策和更新
   - 开放问题

2. 始终查阅项目上下文 (memory://project/context) 以获取最新信息

图表说明

功能流程图

开始 -> 初始化记忆银行 -> 加载上下文 -> 执行任务 -> 更新上下文 -> 结束

开发指南

安装依赖

npm install cline-mcp

启动开发服务器

npm run dev

测试

使用 Jest 框架进行单元测试:

npm test

📄 许可证

MIT License

贡献指南

提交规范

遵循 Conventional Commits 规范。

附录

常见问题解答

如何初始化记忆银行?

运行命令 npx cline-mcp init 即可初始化记忆银行文件。

如何访问项目上下文?

使用 accessMCPResource('memory-bank', 'memory://project/context') 进行访问。

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client