mcp-memo-server

Простой MCP-сервер для управления заметками, который можно использовать из Claude Code. Это пример реализации для обучения. Поддерживается простая аутентификация пользователей (регистрация / вход / токен сессии), заметки разделяются по пользователям.

Предоставляемые инструменты

Заметки сохраняются в memos.json (в корне проекта), информация о пользователях — в users.json. Оба файла добавлены в .gitignore.

Механизм аутентификации (учебный момент)

• Пароль хешируется с солью с помощью стандартного crypto.scrypt из Node.js и сохраняется в users.json (не хранится в открытом виде).

• При успешном login выдаётся случайный токен сессии. Токен хранится только в памяти серверного процесса, срок действия — 2 часа, при перезапуске сервера он теряется.

• add_memo / list_memos / delete_memo проверяют token и возвращают ошибку, если сессия недействительна.

• list_memos / delete_memo фильтруют заметки по userId, связанному с токеном, поэтому чужие заметки не видны.

Примечание: это учебная реализация аутентификации для stdio transport (локальный процесс). В случае stdio, если вы можете запустить сервер, у вас уже есть права на выполнение процесса, поэтому аутентификация здесь предназначена не столько для «настоящей границы безопасности», сколько для «разделения нескольких пользователей» и «изучения реализации потока аутентификации».

Related MCP server: memos-mcp-server

Настройка

npm install
npm run build

Регистрация в Claude Code

После сборки зарегистрируйте сервер, используя абсолютный путь к проекту.

claude mcp add --transport stdio memo-server -- node /絶対パス/mcp-memo-server/build/index.js

Проверка успешной регистрации:

claude mcp list

В сессии Claude Code введите /mcp — вы увидите, что memo-server находится в состоянии connected.

Пример использования (диалог внутри Claude Code)

> ユーザー名 taro、パスワード pass1234 で登録して
> taro でログインして
> 「Qiitaのネタを考える」というメモを追加して
> 今登録されているメモを一覧で見せて
> ID 1 のメモを削除して

Токен, выданный при входе, Claude запоминает в ходе разговора и автоматически использует его в последующих вызовах add_memo / list_memos / delete_memo.

Ручная проверка работы

test-client.mjs — это простой скрипт, который отправляет напрямую JSON-RPC сообщения (initialize → tools/list → tools/call) запущенному как дочерний процесс серверу и проверяет ответы.

node test-client.mjs

Удаление

claude mcp remove memo-server