agent-memory-mcp

1# Agent Memory Skill
2 
3This 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.
4 
5## Prerequisites
6 
7- Node.js (v18+)
8 
9## Setup
10 
111. **Clone the Repository**:
12   Clone the `agentMemory` project into your agent's workspace or a parallel directory:
13 
14   ```bash
15   git clone https://github.com/webzler/agentMemory.git .agent/skills/agent-memory
16   ```
17 
182. **Install Dependencies**:
19 
20   ```bash
21   cd .agent/skills/agent-memory
22   npm install
23   npm run compile
24   ```
25 
263. **Start the MCP Server**:
27   Use the helper script to activate the memory bank for your current project:
28 
29   ```bash
30   npm run start-server <project_id> <absolute_path_to_target_workspace>
31   ```
32 
33   _Example for current directory:_
34 
35   ```bash
36   npm run start-server my-project $(pwd)
37   ```
38 
39## Capabilities (MCP Tools)
40 
41### `memory_search`
42 
43Search for memories by query, type, or tags.
44 
45- **Args**: `query` (string), `type?` (string), `tags?` (string[])
46- **Usage**: "Find all authentication patterns" -> `memory_search({ query: "authentication", type: "pattern" })`
47 
48### `memory_write`
49 
50Record new knowledge or decisions.
51 
52- **Args**: `key` (string), `type` (string), `content` (string), `tags?` (string[])
53- **Usage**: "Save this architecture decision" -> `memory_write({ key: "auth-v1", type: "decision", content: "..." })`
54 
55### `memory_read`
56 
57Retrieve specific memory content by key.
58…