mcp-memo-server
mcp-memo-server
这是一个可以从 Claude Code 使用的简单备忘录管理 MCP 服务器。是用于学习目的的示例实现。 支持简易的用户认证(用户注册 / 登录 / 会话令牌),备忘录按用户进行隔离。
提供的工具
工具名 | 说明 | 参数 |
| 新注册用户 |
|
| 登录并获取会话令牌 |
|
| 添加备忘录(需要登录) |
|
| 获取自己已注册的备忘录列表(需要登录) |
|
| 删除指定 ID 的自己的备忘录(需要登录) |
|
备忘录保存在 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: mcp-memos
设置
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-serverAvailable Tools
5 toolsadd_memoメモを追加A
新しいメモをテキストで追加します。ログインが必要です。
Inputs: text (required), token (required).
delete_memoメモを削除A
指定したIDの自分のメモを削除します。ログインが必要です。
Inputs: id (required), token (required).
list_memosメモ一覧を取得A
自分が登録したメモを一覧表示します。ログインが必要です。
Inputs: token (required).
loginログインA
ユーザー名とパスワードでログインし、セッショントークンを取得します。
Inputs: password (required), username (required).
registerユーザー登録A
ユーザー名とパスワードで新しいアカウントを作成します。
Inputs: password (required), username (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose: register/login handle authentication, while add_memo, list_memos, and delete_memo cover distinct memo operations. There is no meaningful overlap or ambiguity between any two tools.
Most tools follow a clear imperative verb_noun pattern like add_memo, list_memos, and delete_memo. register and login are standard auth verbs without a noun object, and list_memos uses a plural while delete_memo is singular, but the overall naming is predictable and readable.
Five tools is well-scoped for a simple memo server requiring authentication and basic memo management. Every tool earns its place, and there are no redundant or unnecessary additions.
The set covers registration, login, creating memos, listing memos, and deleting memos, but lacks an update/edit memo operation and an explicit logout tool. Editing an existing memo requires deleting and recreating it, which is a notable gap for a memo service.
Maintenance
Related MCP Connectors
An authenticated remote MCP server for user-owned devices and one-shot capability invocation.
Hosted memory for AI agents over MCP. One memory shared by all your agents.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to create, read, update, delete, and list memos via the MCP protocol.3MIT
- AlicenseNot gradedqualityFmaintenanceEnables creating memos and attaching files to a Memos instance via MCP tools.MIT
- AlicenseAqualityDmaintenanceMCP server for creating, listing, updating, deleting memos, and managing attachments via the Memos API.1223 npmMIT
- FlicenseNot gradedqualityDmaintenanceMCP server providing CRUD operations for Memos, enabling users to create, list, get, update, and delete memos via natural language.-