AI Sticky Notes MCP Server

Сервер MCP, который позволяет ИИ-ассистенту сохранять, читать и обобщать личные заметки. Заметки хранятся в локальном файле notes.txt рядом с сервером.

Возможности

• Инструмент add_note: добавляет новую заметку.

• Инструмент read_notes: читает все сохраненные заметки.

• Ресурс notes://latest: возвращает последнюю добавленную заметку.

• Промпт note_summary_prompt: создает промпт, содержащий текущие заметки для обобщения.

Related MCP server: Sticky Notes MCP Server

Требования

• Python 3.12 или новее

• pip или uv

Локальный запуск

Использование uv

uv sync
uv run python main.py

Использование pip

Создайте и активируйте виртуальное окружение, затем установите зависимость:

python -m venv .venv
.venv\Scripts\Activate.ps1
pip install -r requirements.txt
python main.py

Сервер взаимодействует через MCP stdio, поэтому обычно его запускает MCP-совместимый клиент, а не открывает напрямую в браузере.

Тестирование сервера

С установленным MCP CLI запустите MCP Inspector с помощью:

mcp dev main.py

Используйте Inspector для вызова add_note, read_notes, открытия ресурса notes://latest и запуска note_summary_prompt.

Вы также можете напрямую проверить модуль Python и синтаксис:

uv run python -c "import main; print('MCP server import ok')"
uv run python -m py_compile main.py

Развертывание с помощью Smithery

Репозиторий содержит smithery.yaml, который настраивает Smithery на запуск сервера с помощью:

startCommand:
	type: stdio
	command: python
	args: ["main.py"]

Отправьте файлы развертывания в репозиторий GitHub и разверните этот репозиторий через Smithery. Важные файлы:

• main.py

• requirements.txt

• smithery.yaml

Файл notes.txt необязателен, потому что сервер создает его автоматически при необходимости. Включайте его, только если хотите поставлять примеры заметок.

Запуск с Docker

Соберите и запустите включенный образ:

docker build -t ai-sticky-notes .
docker run --rm -i ai-sticky-notes

Структура проекта

main.py          MCP server implementation
requirements.txt Python dependencies
smithery.yaml    Smithery stdio startup configuration
Dockerfile       Container build configuration
notes.txt        Local note storage, created automatically if absent

Примечание о хранении

Заметки хранятся в обычном текстовом файле. Это подходит для локального использования и демонстраций, но размещенные контейнеры могут не сохранять файл между перезапусками или повторными развертываниями. Для надежного производственного хранения следует использовать внешнюю базу данных или постоянный том.