MCP server for AI Agents project based and shareable memory management
npm install mcp-shared-memoryA Model Context Protocol (MCP) server that provides structured memory management across chat sessions for all MCP-enabled tools and applications, specifically designed for project-based work.
> 💡 New in v0.1.2: Version tracking and update notifications! Ask your AI assistant: "What's new in mcp-shared-memory?"
You can run the server directly without installing it:
``json`
{
"mcpServers": {
"shared-memory": {
"command": "npx",
"args": ["-y", "mcp-shared-memory"]
}
}
}
`bashClone the repository
git clone https://github.com/Ideas-Net-Studio/mcp-shared-memory.git
cd mcp-shared-memory
Documentation
| Document | Description |
| ------------------------------------------------------------- | ------------------------------------------------- |
| USAGE.md | Complete usage guide with setup for all MCP tools |
| CHANGELOG.md | Version history and release notes |
| instructions_template.md | AI assistant instructions template |
| CONTRIBUTING.md | Contribution guidelines and workflow |
Compatible Tools
Works with any MCP-enabled tool:
- Claude Desktop - Anthropic's desktop application
- Cursor - AI-powered code editor
- Windsurf - AI development environment
- Cline - VS Code extension for AI assistance
- RooCode - AI coding assistant
- Warp - Modern terminal with AI features
- Antigravity - AI development platform
- And more... - Any tool supporting the Model Context Protocol
Key Features
- Project-Specific Memory: Store memories within project directories
- Flexible Configuration: Hidden or visible configuration files
- Multi-Tool Support: Works seamlessly across all MCP tools
- Git Integration: Share project memories with your team
- Automatic Detection: Smart project configuration detection
- Structured Storage: Organized memory with entities, concepts, and sessions
Project Structure
Create a configuration file in your project root:
$3
json
{
"memoryDir": ".context/memory",
"enabled": true,
"description": "My project"
}
`File:
$3
json
{
"memoryDir": "memory",
"enabled": true,
"description": "My project"
}
`File:
Testing
bash
Run configuration tests
npm testRun server tests
npm run test:serverRun client tests
npm run test:client
`Development
bash
Install dependencies
npm installDevelopment mode
npm run devBuild for production
npm run build
``We welcome contributions! See docs/CONTRIBUTING.md for detailed guidelines on how to fork, modify, and submit PRs.
MIT
---
> For detailed documentation, see the docs/ folder.
> 🍴 Fork Status: This is a fork of the original ebailey78/mcp-memory repository, which appears to no longer be actively maintained. This fork continues development with multi-tool compatibility, enhanced configuration options, and improved testing.