# README.md
# MCP-сервер для управления памятью агента

## Важные упоминания
- **Model Context Protocol (MCP)** – открытый протокол для взаимодействия LLM и внешних систем.
- **langchain-mcp-adapters** – адаптеры LangChain для работы с MCP.
- **FastMCP** – фреймворк для создания серверов и клиентов MCP.
- **HTTP transport** – поддержка HTTP‑транспорта в FastMCP.
- **stdio transport** – поддержка stdio‑транспорта, реализован в примере.
- **stateful sessions** – возможность сохранять состояние сессии (не реализовано, но упомянуто).
- **interceptors** – расширяемые перехватчики запросов.
- **progress notifications** – уведомления о прогрессе.
- **logging** – логирование запросов и ответов.
- **elicitation** – механизм уточнения запросов.
- **MCP specification** – официальная спецификация протокола.
- **MCP registry** – реестр серверов MCP.


## Цель

Создать **MCP‑сервер** (Model Context Protocol) на Python, который предоставляет инструменты для работы с памятью через протокол FastMCP.

## Установка

```bash
pip install -r requirements.txt
```

## Запуск сервера

```bash
python memory_server.py
```

## Тестовый клиент

```bash
python memory_client.py
```

## Инструменты сервера

| Имя | Описание |
|------|----------|
| `save` | Сохраняет значение по ключу |
| `get` | Возвращает значение и метаданные |
| `delete` | Удаляет ключ |
| `list_keys` | Список ключей по шаблону |
| `save_with_namespace` | Сохраняет в namespace |
| `get_by_namespace` | Возвращает все ключи из namespace |

## Файловое хранилище

Данные сохраняются в `memory_data.json` в формате:

```json
{
  "default:user_name": {
    "value": "Алексей",
    "timestamp": "2026-05-15T10:30:00"
  }
}
```