MCP Memory Server

Overview

This repository contains a simple MCP (Model Context Protocol) server that provides basic key‑value memory operations with optional namespace support. The server is built on top of the fastmcp framework and stores data in a JSON file.

The project also includes a small client script demonstrating how to interact with the server via MCP stdio transport.

File Structure

memory_server.py – Implements the MCP server with tools: save, get, delete, list_keys, save_with_namespace, get_by_namespace.
memory_client.py – Example client that connects to the server and performs a few operations.
requirements.txt – Python dependencies.
README.md – Project documentation.

Installation

pip install -r requirements.txt

Running the Server

python memory_server.py

The server listens on stdio transport and can be used by any MCP client.

Using the Client

python memory_client.py

This script demonstrates:

Saving a value with namespace default.
Retrieving all items in that namespace.
Listing keys matching a pattern.

The expected output is similar to:

Сохранено: True
Данные namespace 'default':
  username: Алексей
Ключи с 'name': ['default:user_name']

MCP Tool Details

Tool	Purpose
`save`	Store a value under a key.
`get`	Retrieve the stored item for a key.
`delete`	Remove a key from storage.
`list_keys`	List all keys with optional glob pattern.
`save_with_namespace`	Store a value under `namespace:key`.
`get_by_namespace`	Return all items belonging to a namespace.

Notes

Data is persisted in memory_data.json located next to the script.
Timestamps are stored in UTC ISO format.
The server uses atomic writes for safety.
Wildcard patterns use Unix shell syntax via fnmatch.

Feel free to extend or adapt this example for your own multi‑agent systems.

2.0 KiB Raw Blame History Unescape Escape