mcp-memo-server

这是一个可以从 Claude Code 使用的简单备忘录管理 MCP 服务器。是用于学习目的的示例实现。 支持简易的用户认证（用户注册 / 登录 / 会话令牌），备忘录按用户进行隔离。

提供的工具

备忘录保存在 memos.json（项目根目录）中，用户信息保存在 users.json 中。两者均已加入 .gitignore。

认证机制（学习要点）

• 密码使用 Node.js 标准的 crypto.scrypt 进行加盐哈希后保存到 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