Back to MCP directory
publicPublicdnsLocal runtime

memory-bank-mcp-server-2.2.1

一个基于Model Context Protocol (MCP)的记忆银行服务器,用于跨会话管理项目文档和上下文,帮助AI代理(如Claude)通过结构化的JSON格式存储全局和分支特定的记忆库来维护一致的项目知识。

article

README

🚀 内存银行 MCP 服务器

本项目是一个内存银行实现,主要用于管理项目文档和技术背景,确保其在不同会话间保持一致。借助模型上下文协议(MCP),该服务器能帮助 AI 代理(如 Claude)维持跨项目的知识一致性。相关知识以全局和分支特定的内存银行形式存在,采用结构化的 JSON 格式进行存储。

项目灵感源自 Cline Memory Bank,来自 nickbaumann98/cline_docs 仓库。

🚀 快速开始

先决条件

  • Node.js(可参考 .tool-versions 以使用推荐版本)
  • Yarn(v1.x)

安装

从仓库根目录克隆项目并安装依赖:

git clone https://github.com/t3ta/memory-bank-mcp-server.git
cd memory-bank-mcp-server
yarn install

运行 MCP 服务器

可直接在单仓库管理中运行 MCP 服务器:

# 在单仓库管理根目录下执行
yarn workspace @memory-bank/mcp start --docs /path/to/your/docs

请将 /path/to/your/docs 替换为实际的项目文档路径,global-memory-bankbranch-memory-bank 文件或文件夹将在此处创建或已存在。

更多关于运行服务器和选项的信息,请参阅 packages/mcp/README.md

✨ 主要特性

  • 借助 MCP 协议,助力 AI 代理维护跨项目的知识一致性。
  • 以结构化 JSON 格式存储知识,便于管理和使用。
  • 采用单仓库管理(monorepo),使用 Yarn 工作区进行管理,结构清晰。

📦 安装指南

安装依赖

git clone https://github.com/t3ta/memory-bank-mcp-server.git
cd memory-bank-mcp-server
yarn install

运行服务器

yarn workspace @memory-bank/mcp start --docs /path/to/your/docs

📚 详细文档

包结构

此仓库采用单仓库管理(monorepo),使用 Yarn 工作区管理,包含以下包:

  • packages/mcp:MCP 服务器的核心实现,涵盖处理内存银行操作、MCP 工具执行和服务器启动的主要逻辑。
  • packages/schemas:定义用于内存银行文档(如 memory_document_v2)的 JSON 模式。
  • packages/vscode-extension:一个 VSCode 扩展,可实现与内存银行 MCP 服务器的集成(详细信息待定)。

开发相关

  • 构建所有包yarn build
  • 为所有包运行测试yarn test
  • 检查代码yarn lint

如需更多特定于包的开发说明,请参考每个包目录中的 README 文件。

📄 许可证

本项目采用 MIT 许可证,详细信息请参阅 LICENSE 文件。

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