hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Integrations
Integrates with Git branch structure to organize and manage branch-specific memory banks, automatically detecting current branches and maintaining context across feature or fix branches
Utilizes GitHub Actions for automated testing across multiple Node.js versions and automated release processes including version bumping, tagging, and npm publishing
Supports Markdown format for memory bank documents with migration tools to convert to the newer JSON format
Memory Bank MCP Server
A Memory Bank implementation for managing project documentation and context across sessions using the Model Context Protocol (MCP). This server helps AI agents like Claude maintain consistent project knowledge through global and branch-specific memory banks stored in a structured JSON format.
This project is inspired by Cline Memory Bank from the nickbaumann98/cline_docs repository.
Packages
This repository is a monorepo managed with Yarn Workspaces. It contains the following packages:
packages/mcp
: The core MCP server implementation. Contains the main logic for handling memory bank operations, MCP tool execution, and server startup.packages/schemas
: Defines the JSON schemas used for memory bank documents (e.g.,memory_document_v2
).packages/vscode-extension
: A VSCode extension providing integration with the Memory Bank MCP server (details TBD).
Getting Started
Prerequisites
- Node.js (see
.tool-versions
for recommended version) - Yarn (v1.x)
Installation
Clone the repository and install dependencies from the root directory:
Running the MCP Server
You can run the MCP server directly from the monorepo:
Replace /path/to/your/docs
with the actual path to your project's documentation directory (where global-memory-bank
and branch-memory-bank
will reside or be created).
See the packages/mcp/README.md
for more details on running the server and its options.
Development
- Build all packages:
yarn build
- Run tests for all packages:
yarn test
- Lint code:
yarn lint
Refer to the README file within each package directory for package-specific development instructions.
License
This project is licensed under the MIT License. See the LICENSE file for details.
This server cannot be installed
A server for managing project documentation and context across Claude AI sessions through global and branch-specific memory banks, enabling consistent knowledge management with structured JSON document storage.