Skip to main content
Glama
mcp-memo-server

mcp-memo-server

by shinji0214

mcp-memo-server

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

提供的工具

工具名

说明

参数

register

新注册用户

username: string, password: string

login

登录并获取会话令牌

username: string, password: string

add_memo

添加备忘录(需要登录)

token: string, text: string

list_memos

获取自己已注册的备忘录列表(需要登录)

token: string

delete_memo

删除指定 ID 的自己的备忘录(需要登录)

token: string, id: number

备忘录保存在 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-server

Available Tools

5 tools
add_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

    A3.9/5.0

    Scored across 5 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness3/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers