MCP Notes

Notas del MCP

Un sistema de gestión de conocimiento personal basado en el Protocolo de Contexto Modelo (MCP) que transforma las notas diarias en conocimiento organizado y buscable.

🚀 Uso

🛠️ Configuración manual

1. Clonar el repositorio
   git clone git@github.com:markacianfrani/mcp-notes.git cd mcp-notes npm i npm run build
2. Configurar MCP

🖥️ Claude Desktop

Agregue a su claude-desktop-config.json:

🌟 Visión del Proyecto

MCP Notes tiene como objetivo resolver el problema de la fragmentación del conocimiento mediante la creación de un sistema donde los pensamientos, logros y perspectivas diarias puedan ser:

1. 📥 Capturado rápidamente con mínima fricción
2. 🗂️ Organizado automáticamente en estructuras significativas
3. 🧠 Sintetizado en conocimiento de nivel superior
4. 🔍Se recupera fácilmente cuando es necesario

El objetivo es construir un pato de goma externo que pueda volcar su memoria de trabajo en tiempo real desde cualquier herramienta y clasificar la basura.

🧩 Conceptos básicos

1. 📅 Registros diarios

Los registros diarios son la unidad de captura principal en MCP Notes. Cada día tiene su propio archivo Markdown donde puedes registrar observaciones a lo largo del día. Piensa en los registros diarios como un libro de contabilidad.

💡 SUGERENCIA: Utilice el acceso directo del teclado de entrada rápida de Claude Desktop

MCP es independiente de la herramienta, por lo que puede registrar conversaciones pero también herramientas: pídale a Copilot o Cursor que registren un resumen de las lecciones aprendidas después de corregir un error o haga que Claude Desktop guarde un nuevo enfoque para un viejo problema.

2. 📊 Rollups

Los rollups son resúmenes generados automáticamente que condensan los registros diarios en información y patrones de mayor nivel. Ayudan a conectar información aislada en una narrativa coherente de tu trabajo y tu pensamiento.

3. 📚 Categorías de conocimiento

Todas las notas del sistema entran en una de cuatro categorías:

• 🏆 Logro : Resolver problemas, completar funciones, corregir errores
• 💡 Insight : Patrones, decisiones arquitectónicas, mejores formas de trabajar
• 📝 TODO : Tareas relacionadas con objetivos más amplios, mejoras significativas
• 📖 Conocimiento : Detalles técnicos, contexto, fundamentos, técnicas

🎨 Principios de diseño

MCP Notes se basa en varios principios de diseño básicos:

1. 📄 Texto simple primero

Todas las notas se almacenan como archivos Markdown de texto sin formato, lo que garantiza:

• Almacenamiento a prueba de futuro que no estará limitado a formatos propietarios
• Compatibilidad con el control de versiones
• Edición fácil con cualquier editor de texto
• Estructura de datos transparente

2. ✍️ Captura de baja fricción

La interfaz principal está diseñada para minimizar la fricción al registrar pensamientos:

• Entrada de texto simple
• Asistencia de categorización automática
• No se requiere una organización compleja en el momento de la captura

3. 🔄 Organización progresista

En lugar de requerir una organización rígida desde el principio, MCP Notes emplea un enfoque progresivo:

• Captura pensamientos y actividades en bruto
• Categorizar automáticamente el contenido
• Generar resúmenes periódicos
• Conectar elementos relacionados a lo largo del tiempo

4. 🤖 Aumento de IA

El sistema aprovecha la IA para mejorar el pensamiento humano, no para reemplazarlo:

• Ayuda a categorizar la información
• Generar resúmenes y conexiones
• Notas pasadas relevantes de la superficie
• Identificar patrones a lo largo del tiempo

🧰 Herramientas disponibles

MCP Notes ofrece un conjunto de herramientas que se pueden invocar a través de Claude Desktop u otros clientes compatibles con MCP. Estas herramientas permiten capturar, organizar y recuperar notas.

Herramientas de notas básicas

/log

Crea o actualiza el archivo de registro diario de hoy con tus notas.

Invocar con: "registrar esto en mi registro diario: ...", "agregar un resumen de eso a mi registro: ...."

/rollup

Sintetiza notas diarias en un resumen organizado con categorías, conexiones y elementos de acción.

Invocar con: "recopilar mis notas de hoy"

write_note

Crea una nueva nota o sobrescribe una nota existente con contenido.

sticky

Evalúa la "adhesividad" de un pensamiento en función de su viabilidad, longevidad, facilidad de búsqueda y valor de referencia futuro.

Invocar con: "¿Es esta idea pegajosa?"

evaluateInsight

Evalúa el valor y la importancia a largo plazo de una idea o pensamiento.

Invoque con: "¿Es este conocimiento valioso a largo plazo?"

Herramientas del sistema de archivos

search_files

Busca recursivamente archivos y directorios que coincidan con un patrón en su directorio de notas.

read_note

Lee el contenido completo de un archivo de notas desde su directorio de notas.

read_multiple_notes

Lee el contenido de varios archivos de notas simultáneamente.

list_directory

Enumera el contenido de un directorio en sus notas.

create_directory

Crea un nuevo directorio en tus notas.

Consulte el archivo CHANGELOG.md para ver el historial de versiones y los cambios.

💡 Indicaciones disponibles

¿Esto es atómico?

Desglosa las ideas en sus partes más simples e independientes. Usa esta instrucción para convertir ideas extensas en conceptos más pequeños. Las notas más pequeñas se pueden vincular con otras notas mucho más fácilmente.