Agent Memory MCP

1---
2name: agent-memory-mcp
3author: Amit Rathiesh
4description: A hybrid memory system that provides persistent, searchable knowledge management for AI agents (Architecture, Patterns, Decisions).
5---
6 
7# Agent Memory Skill
8 
9This skill provides a persistent, searchable memory bank that automatically syncs with project documentation. It runs as an MCP server to allow reading/writing/searching of long-term memories.
10 
11## Prerequisites
12 
13- Node.js (v18+)
14 
15## Setup
16 
171. **Clone the Repository**:
18   Clone the `agentMemory` project into your agent's workspace or a parallel directory:
19 
20   ```bash
21   git clone https://github.com/webzler/agentMemory.git .agent/skills/agent-memory
22   ```
23 
242. **Install Dependencies**:
25 
26   ```bash
27   cd .agent/skills/agent-memory
28   npm install
29   npm run compile
30   ```
31 
323. **Start the MCP Server**:
33   Use the helper script to activate the memory bank for your current project:
34 
35   ```bash
36   npm run start-server <project_id> <absolute_path_to_target_workspace>
37   ```
38 
39   _Example for current directory:_
40 
41   ```bash
42   npm run start-server my-project $(pwd)
43   ```
44 
45## Capabilities (MCP Tools)
46 
47### `memory_search`
48 
49Search for memories by query, type, or tags.
50 
51- **Args**: `query` (string), `type?` (string), `tags?` (string[])
52- **Usage**: "Find all authentication patterns" -> `memory_search({ query: "authentication", type: "pattern" })`
53 
54### `memory_write`
55 
56Record new knowledge or decisions.
57 
58- **Args**: `key` (string), `type` (string), `content` (string), `tags?` (string[])
59- **Usage**: "Save this architecture decision" -> `memory_write({ key: "auth-v1", type: "decision", content: "..." })`
60 
61### `memory_read`
62 
63Retrieve specific memory content by key.
64 
65- **Args**: `key` (string)
66- **Usage**: "Get the auth design" -> `memory_read({ key: "auth-v1" })`
67 
68### `memory_stats`
69 
70View analytics on memory usage.
71 
72- **Usage**: "Show memory statistics" -> `memory_stats({})`
73 
74## Dashboard
75 
76This skill includes a standalone dashboard to visualize memory usage.
77 
78```bash
79npm run start-dashboard <absolute_path_to_target_workspace>
80```
81 
82Access at: `http://localhost:3333`
83