170 lines
5.9 KiB
Python
170 lines
5.9 KiB
Python
# memory_server.py
|
|
|
|
from fastmcp import FastMCP
|
|
import json
|
|
from datetime import datetime
|
|
from pathlib import Path
|
|
from typing import Any, Optional, List
|
|
import fnmatch
|
|
|
|
|
|
class MemoryServer:
|
|
"""
|
|
MCP‑сервер для управления памятью с поддержкой namespaces.
|
|
"""
|
|
|
|
def __init__(self):
|
|
# Инициализируем FastMCP
|
|
self.mcp = FastMCP("Memory-Server")
|
|
# Путь к файлу хранения данных
|
|
self.storage_path = Path("./memory_data.json")
|
|
|
|
# ------------------------------------------------------------------
|
|
# Вспомогательные методы для работы с JSON‑файлом
|
|
# ------------------------------------------------------------------
|
|
def _load_memory(self) -> dict:
|
|
"""Загружает память из JSON‑файла."""
|
|
if not self.storage_path.exists():
|
|
return {}
|
|
with open(self.storage_path, "r", encoding="utf-8") as f:
|
|
return json.load(f)
|
|
|
|
def _save_memory(self, data: dict):
|
|
"""Сохраняет память в JSON‑файл."""
|
|
self.storage_path.parent.mkdir(parents=True, exist_ok=True)
|
|
with open(self.storage_path, "w", encoding="utf-8") as f:
|
|
json.dump(data, f, indent=2, ensure_ascii=False)
|
|
|
|
# ------------------------------------------------------------------
|
|
# Инструменты FastMCP
|
|
# ------------------------------------------------------------------
|
|
|
|
@self.mcp.tool()
|
|
def save(key: str, value: Any) -> bool:
|
|
"""
|
|
Сохраняет значение по ключу в память сервера.
|
|
|
|
Args:
|
|
key: Идентификатор для сохранения (уникальный ключ).
|
|
value: Любое сериализуемое значение.
|
|
|
|
Returns:
|
|
True при успешном сохранении, False иначе.
|
|
"""
|
|
data = self._load_memory()
|
|
# Проверяем наличие опасных символов в ключе
|
|
if "/" in key or "\\" in key:
|
|
return False
|
|
data[key] = {
|
|
"value": value,
|
|
"timestamp": datetime.utcnow().isoformat(),
|
|
}
|
|
self._save_memory(data)
|
|
return True
|
|
|
|
@self.mcp.tool()
|
|
def get(key: str) -> Optional[dict]:
|
|
"""
|
|
Возвращает значение по ключу с метаданными.
|
|
|
|
Args:
|
|
key: Идентификатор для поиска.
|
|
|
|
Returns:
|
|
Словарь с полями {"key": ..., "value": ..., "timestamp": ...}
|
|
или None если ключ не найден.
|
|
"""
|
|
data = self._load_memory()
|
|
if key not in data:
|
|
return None
|
|
entry = data[key]
|
|
return {
|
|
"key": key,
|
|
"value": entry["value"],
|
|
"timestamp": entry["timestamp"],
|
|
}
|
|
|
|
@self.mcp.tool()
|
|
def delete(key: str) -> bool:
|
|
"""
|
|
Удаляет ключ из памяти сервера.
|
|
|
|
Args:
|
|
key: Идентификатор для удаления.
|
|
|
|
Returns:
|
|
True при успешном удалении, False если ключ не найден.
|
|
"""
|
|
data = self._load_memory()
|
|
if key not in data:
|
|
return False
|
|
del data[key]
|
|
self._save_memory(data)
|
|
return True
|
|
|
|
@self.mcp.tool()
|
|
def list_keys(pattern: str = "*") -> List[str]:
|
|
"""
|
|
Возвращает список всех ключей с поддержкой wildcard‑паттерна.
|
|
|
|
Args:
|
|
pattern: Паттерн для фильтрации (поддерживает * и ?).
|
|
|
|
Returns:
|
|
Список совпадающих ключей.
|
|
"""
|
|
data = self._load_memory()
|
|
return [k for k in data.keys() if fnmatch.fnmatch(k, pattern)]
|
|
|
|
# ------------------------------------------------------------------
|
|
# Инструменты с поддержкой namespaces
|
|
# ------------------------------------------------------------------
|
|
|
|
@self.mcp.tool()
|
|
def save_with_namespace(key: str, value: Any, namespace: str = "default") -> bool:
|
|
"""
|
|
Сохраняет значение с указанием пространства имён.
|
|
|
|
Args:
|
|
key: Идентификатор.
|
|
value: Значение для сохранения.
|
|
namespace: Пространство имён (по умолчанию 'default').
|
|
|
|
Returns:
|
|
True при успехе, False иначе.
|
|
"""
|
|
full_key = f"{namespace}:{key}"
|
|
return self.save(full_key, value)
|
|
|
|
@self.mcp.tool()
|
|
def get_by_namespace(namespace: str = "default") -> List[dict]:
|
|
"""
|
|
Возвращает все ключи из указанного namespace.
|
|
|
|
Args:
|
|
namespace: Пространство имён для чтения.
|
|
|
|
Returns:
|
|
Список словарей с метаданными всех ключей namespace.
|
|
"""
|
|
data = self._load_memory()
|
|
prefix = f"{namespace}:"
|
|
result = []
|
|
for k, v in data.items():
|
|
if k.startswith(prefix):
|
|
result.append(
|
|
{
|
|
"key": k,
|
|
"value": v["value"],
|
|
"timestamp": v["timestamp"],
|
|
}
|
|
)
|
|
return result
|
|
|
|
|
|
# ----------------------------------------------------------------------
|
|
# Запуск сервера
|
|
# ----------------------------------------------------------------------
|
|
if __name__ == "__main__":
|
|
server = MemoryServer()
|
|
server.mcp.run(transport="stdio", show_banner=False, log_level="ERROR") |