MCP Notes

by markacianfrani
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Uses Git for version control of notes, allowing cloning of the repository and tracking changes to the knowledge base over time

  • Stores all notes as plain text Markdown files, ensuring future-proof storage, easy editing, and transparent data structures

  • Utilizes npm for package management and installation of the server's dependencies

📚 MCP 노트

모델 컨텍스트 프로토콜(MCP)을 기반으로 구축된 개인 지식 관리 시스템으로, 일상적인 메모를 체계적으로 정리하고 검색 가능한 지식으로 변환합니다.

🚀 사용법

🛠️ 수동 설정

  1. 저장소를 복제합니다지엑스피1
  2. MCP 설정

🖥️ 클로드 데스크탑

claude-desktop-config.json에 다음을 추가합니다.

"notes": { "command": "node", "args": [ "path/to/this/repo/mcp-notes/dist/index.js", "path/to/your/notes" ], },

🌟 프로젝트 비전

MCP Notes는 일상적인 생각, 성과, 통찰력을 다음과 같이 정리할 수 있는 시스템을 구축하여 지식 단편화 문제를 해결하는 것을 목표로 합니다.

  1. 📥 최소한의 마찰로 빠르게 캡처
  2. 🗂️ 의미 있는 구조로 자동 구성됨
  3. 🧠 더 높은 수준의 지식으로 합성됨
  4. 🔍 필요할 때 쉽게 검색 가능

목표는 어떤 도구에서든 실시간으로 작업 기억을 꺼내 쓰레기를 분류할 수 있는 외부 고무 오리를 만드는 것입니다.

🧩 핵심 개념

1. 📅 일일 기록

MCP Notes에서 일일 기록은 핵심적인 정보 수집 단위입니다. 각 날짜마다 하루 동안의 관찰 내용을 기록할 수 있는 마크다운 파일이 제공됩니다. 일일 기록은 누적 원장이라고 생각하면 됩니다.

💡 팁: Claude Desktop의 빠른 입력 키보드 단축키를 활용하세요

MCP는 도구에 구애받지 않으므로 대화뿐만 아니라 도구에 대해서도 /log를 사용할 수 있습니다. 버그를 수정한 후 Copilot이나 Cursor에게 얻은 교훈 요약을 기록해 달라고 요청하거나 Claude Desktop에게 오래된 문제에 대한 새로운 접근 방식을 저장하도록 할 수 있습니다.

2. 📊 롤업

롤업은 일일 로그를 더 높은 수준의 통찰력과 패턴으로 압축하여 자동으로 생성되는 요약입니다. 개별적인 정보 조각들을 연결하여 작업과 사고에 대한 일관된 이야기를 만들어내는 데 도움이 됩니다.

3. 📚 지식 카테고리

시스템의 모든 노트는 다음 네 가지 범주 중 하나에 속합니다.

  • 🏆 성취 : 문제 해결, 기능 완성, 버그 수정
  • 💡 통찰력 : 패턴, 아키텍처 결정, 더 나은 작업 방식
  • 📝 TODO : 더 큰 목표와 관련된 작업, 의미 있는 개선 사항
  • 📖 지식 : 기술적 세부 사항, 맥락, 근거, 기술

🎨 디자인 원칙

MCP Notes는 다음과 같은 몇 가지 핵심 설계 원칙을 기반으로 구축되었습니다.

1. 📄 일반 텍스트 먼저

모든 메모는 일반 텍스트 Markdown 파일로 저장되어 다음이 보장됩니다.

  • 독점적인 포맷에 얽매이지 않는 미래 지향적 스토리지
  • 버전 제어 호환성
  • 모든 텍스트 편집기로 쉽게 편집 가능
  • 투명한 데이터 구조

2. ✍️ 낮은 마찰 캡처

기본 인터페이스는 생각을 기록하는 과정에서 발생하는 마찰을 최소화하도록 설계되었습니다.

  • 간단한 텍스트 입력
  • 자동 분류 지원
  • 캡처 시점에 복잡한 구성이 필요하지 않습니다.

3. 🔄 진보적 조직

MCP Notes는 처음부터 엄격한 조직을 요구하는 대신 점진적인 접근 방식을 채택합니다.

  • 생생한 생각과 활동을 포착하세요
  • 콘텐츠를 자동으로 분류합니다
  • 주기적 요약 생성
  • 시간 경과에 따라 관련 항목 연결

4. 🤖 AI 증강

이 시스템은 AI를 활용해 인간의 사고를 대체하는 것이 아니라 향상시킵니다.

  • 정보 분류에 도움
  • 요약 및 연결 생성
  • 표면 관련 과거 노트
  • 시간에 따른 패턴 식별

🧰 사용 가능한 도구

MCP Notes는 Claude Desktop 또는 다른 MCP 호환 클라이언트를 통해 사용할 수 있는 도구 세트를 제공합니다. 이러한 도구를 사용하면 노트를 캡처, 정리 및 검색할 수 있습니다.

📝 코어 노트 도구

/log

귀하의 메모를 바탕으로 오늘의 일일 기록 파일을 만들거나 업데이트합니다.

"내 일일 기록에 이것을 기록하세요: ...", "내 기록에 요약을 추가하세요: ...."로 호출합니다.

/rollup

일일 메모를 범주, 연결, 작업 항목 등을 사용하여 체계적으로 정리된 요약으로 종합합니다.

"오늘의 노트를 롤업"으로 호출합니다.

write_note

새로운 메모를 만들거나 기존 메모에 내용을 덮어씁니다.

sticky

실행 가능성, 지속성, 발견 가능성, 미래 참조 가치를 기준으로 생각의 "점착성"을 평가합니다.

"이 아이디어가 매력적인가요?"라는 질문을 던지세요.

evaluateInsight

통찰력이나 생각의 장기적 가치와 중요성을 평가합니다.

"이 통찰력이 장기적으로 가치가 있나요?"라는 질문을 던지세요.

📂 파일 시스템 도구

search_files

메모 디렉토리에서 패턴과 일치하는 파일과 디렉토리를 재귀적으로 검색합니다.

read_note

메모 디렉토리에서 메모 파일의 전체 내용을 읽습니다.

read_multiple_notes

여러 개의 노트 파일의 내용을 동시에 읽습니다.

list_directory

노트에 있는 디렉토리의 내용을 나열합니다.

create_directory

메모에 새 디렉토리를 만듭니다.

버전 기록과 변경 사항은 CHANGELOG.md 파일을 참조하세요.

💡 사용 가능한 프롬프트

이게 원자적이에요?

아이디어를 가장 단순한 독립된 부분으로 나눕니다. 이 프롬프트를 사용하여 큰 아이디어를 더 작은 개념으로 전환합니다. 작은 메모는 다른 메모와 훨씬 더 쉽게 연결할 수 있습니다.

ID: timi8dkawo