mcp-memo-server

Claude Code에서 사용할 수 있는 간단한 메모 관리 MCP 서버입니다. 학습용 샘플 구현입니다. 간단한 사용자 인증(사용자 등록 / 로그인 / 세션 토큰)을 지원하며, 메모는 사용자별로 분리됩니다.

제공하는 도구

메모는 memos.json(프로젝트 바로 아래)에, 사용자 정보는 users.json에 저장됩니다. 둘 다 .gitignore 처리되어 있습니다.

인증 구조(학습 포인트)

• 비밀번호는 Node.js 표준의 crypto.scrypt로 솔트(salt)가 포함된 해시로 변환하여 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