MCP 服务器

memory-server

A memory management MCP server that stores and retrieves key-value data with namespaces, enabling agents to persist and query memory.

README

MCP Memory Server

Описание решения

В этом репозитории реализован MCP‑сервер для управления памятью агентов, а также клиент‑демонстрация.

Файлы и их назначение

Файл	Что делает
`memory_server.py`	Основной сервер. Реализует инструменты: `save`, `get`, `delete`, `list_keys`, `save_with_namespace`, `get_by_namespace`. Хранит данные в JSON‑файле с метаданными (`timestamp`). Поддерживает namespaces через префикс `namespace:key`.
`memory_client.py`	Асинхронный клиент, демонстрирующий работу сервера. Сохраняет и читает данные, а также ищет ключи по паттерну.
`requirements.txt`	Зависимости проекта: `fastmcp`, `pydantic`, `python-dotenv`.
`README.md`	Текущий файл – описание реализации.

Как запустить

Установите зависимости:
```
pip install -r requirements.txt
```
Запустите сервер (в отдельном терминале):
```
python memory_server.py
```
В другом терминале выполните клиентскую демонстрацию:
```
python memory_client.py
```

Вы увидите вывод, аналогичный следующему:

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

Тесты

Для проверки корректности работы можно написать unit‑тесты, но они не включены в репозиторий.

Важно: сервер запускается без аргументов командной строки и использует транспорт stdio. Клиент подключается к нему как subprocess. Это соответствует требованиям задания.