zhitongblog/solomd

해결하는 문제

SoloMD는 AI 에이전트가 사용자의 노트에서 직접 활동할 수 있는 환경을 제공하도록 설계된 로컬 우선 Markdown 에디터입니다. 일급 에이전트 인터페이스, MCP (Model Context Protocol) 엔드포인트, 버전 관리 볼트를 통합하여 AI 워크플로우의 파편화 문제를 해결합니다. 사용자는 개인 정보 보호나 데이터 소유권을 희생하지 않고도 노트와 대화하고 예약된 레시피를 통해 작업을 자동화할 수 있습니다.

작동 방식

SoloMD는 Markdown 파일 폴더를 기반으로 작동하며, 세 가지 핵심 구성 요소를 결합합니다.

• 에디터: 의미론적 검색, 위키 링크, tldraw 화이트보드 기능을 갖춘 WYSIWYG 에디터.
• 엔드포인트: 13개의 내장 도구를 사용하여 MCP 호환 AI 클라이언트(Claude Desktop 또는 Cursor 등)에 볼트를 노출하는 번들 solomd-mcp 바이너리.
• 에이전트 인터페이스: 스트리밍 방식의 '볼트와 대화하기' 및 '레시피'(YAML로 정의된 작업, 예: 주간 리뷰, TODO 추출)를 위한 통합 패널. 이 작업은 별도의 AutoGit 브랜치에서 실행됩니다. 이를 통해 AI가 생성한 변경 사항은 샌드박스에 격리되며, 사용자가 메인 브랜치에 병합하기 전에 승인하거나 거부해야 합니다.

대상 사용자

AI 에이전트가 능동적으로 관리할 수 있는 강력하고 비공개적인 로컬 우선 지식 베이스를 원하는 사용자, MCP 클라이언트를 사용하는 개발자, 그리고 내장된 버전 관리와 AI 지원이 포함된 Markdown 기반 워크플로우를 선호하는 작가에게 적합합니다.

주요 특징

• 에이전트 네이티브 워크플로우: 통합 에이전트 패널과 안전한 AI 쓰기를 위한 샌드박스(AutoGit) 기반의 예약된 레시피.
• MCP 통합: 외부 LLM 클라이언트가 동일한 볼트를 제어할 수 있도록 하는 번들 MCP 서버.
• MCP 페더레이션: 단일 MCP 세션에서 여러 볼트를 처리하는 기능.
• 로컬 우선 및 비공개: 모든 노트, API 키(OS 키체인에 저장), 임베딩 벡터는 기기에 유지되며 클라우드 서버가 필요하지 않습니다.
• 지식 그래프 레이어: YAML 프론트매터, 유형화된 관계, 관계 그래프를 위한 속성 검사기.
• 광범위한 AI 제공업체 지원: Ollama를 통한 로컬 모델을 포함하여 14개의 BYOK (Bring Your Own Key) 제공업체 지원.
• AutoGit 버전 관리: 저장할 때마다 자동으로 로컬 커밋이 생성되어 노트별로 완벽한 기록을 보장합니다.