mcpField
A
agent-memory-mcp

agent-memory-mcp

github.com/davila7Agent workflows33.0k575 installsUpdated 1d ago
Repository

About agent-memory-mcp

A persistent, searchable memory bank for agents that syncs with project documentation. It runs as an MCP server for long-term memory operations and includes a standalone dashboard.

Key features

  1. 01Search by query, type, or tags
  2. 02Write memories and decisions
  3. 03Read specific memories by key
  4. 04View memory usage statistics
  5. 05Visualize memory usage in a dashboard

Use cases

  1. 01Recording project architecture decisions
  2. 02Finding past patterns or project memories

MCP support

It runs as an MCP server and exposes tools for searching, writing, reading, and viewing statistics for long-term memories.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/davila7/claude-code-templates --skill agent-memory-mcp

After installing, type/agent-memory-mcpin Claude Code to confirm it loaded.

Details

From the project README

Agent Memory Skill

This 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.

Prerequisites

  • Node.js (v18+)

Setup

  1. Clone the Repository: Clone the agentMemory project into your agent's workspace or a parallel directory:

    git clone https://github.com/webzler/agentMemory.git .agent/skills/agent-memory

  2. Install Dependencies:

    cd .agent/skills/agent-memory
npm install
npm run compile

  3. Start the MCP Server: Use the helper script to activate the memory bank for your current project:

    npm run start-server <project_id> <absolute_path_to_target_workspace>

    Example for current directory:

    npm run start-server my-project $(pwd)

Capabilities (MCP Tools)

memory_search

Search for memories by query, type, or tags.

  • Args: query (string), type? (string), tags? (string[])
  • Usage: "Find all authentication patterns" -> memory_search({ query: "authentication", type: "pattern" })
memory_write

Record new knowledge or decisions.

  • Args: key (string), type (string), content (string), tags? (string[])
  • Usage: "Save this architecture decision" -> memory_write({ key: "auth-v1", type: "decision", content: "..." })
memory_read

Retrieve specific memory content by key.

  • Args: key (string)
  • Usage: "Get the auth design" -> memory_read({ key: "auth-v1" })
memory_stats

View analytics on memory usage.

  • Usage: "Show memory statistics" -> memory_stats({})

Dashboard

This skill includes a standalone dashboard to visualize memory usage.

npm run start-dashboard <absolute_path_to_target_workspace>

Access at: http://localhost:3333

Comments

Markdown supported