mcp-memo-server

Es un sencillo servidor MCP de gestión de notas que se puede utilizar desde Claude Code. Es una implementación de ejemplo con fines didácticos. Admite una autenticación de usuario simplificada (registro de usuario / inicio de sesión / token de sesión), y las notas quedan separadas por usuario.

Herramientas disponibles

Las notas se guardan en memos.json (en la raíz del proyecto) y la información de los usuarios en users.json. Ambos ya están en .gitignore.

Cómo funciona la autenticación (punto de aprendizaje)

• Las contraseñas se guardan con hash y sal mediante crypto.scrypt, el estándar de Node.js, en users.json (no se almacenan en texto plano).

• Un inicio de sesión correcto en login emite un token de sesión aleatorio. El token se gestiona únicamente en la memoria del proceso del servidor, caduca a las 2 horas y se invalida al reiniciar el servidor.

• add_memo / list_memos / delete_memo validan el token y devuelven un error si no hay una sesión válida.

• list_memos / delete_memo filtran las notas por el userId vinculado al token, por lo que las notas de otras personas no son visibles.

Nota: se trata de una implementación de autenticación con fines didácticos sobre transporte stdio (proceso local). En el caso de stdio, si puedes arrancar el servidor ya tienes permisos de ejecución sobre el proceso, por lo que esta autenticación no es una «frontera de seguridad real», sino que busca «diferenciar varios usuarios» y «aprender a implementar un flujo de autenticación».

Related MCP server: memos-mcp-server

Configuración

npm install
npm run build

Registro en Claude Code

Después de compilar, regístralo usando la ruta absoluta del proyecto.

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

Comprueba que se ha registrado:

claude mcp list

Dentro de una sesión de Claude Code, escribe /mcp y podrás ver que memo-server aparece como connected.

Ejemplo de uso (conversación dentro de Claude Code)

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

El token emitido al iniciar sesión es recordado por Claude durante la conversación y se reutiliza automáticamente en las llamadas posteriores a add_memo / list_memos / delete_memo.

Verificación manual del funcionamiento

test-client.mjs es un script sencillo que envía mensajes JSON-RPC directamente al servidor lanzado como subproceso (initialize → tools/list → tools/call) y comprueba las respuestas.

node test-client.mjs

Para eliminarlo

claude mcp remove memo-server