Vault — 소형 개인 MCP 서버

메모 + 북마크를 단일 SQLite 파일에 저장하고, 5가지 도구를 통해 Claude에 제공합니다: add_note, add_bookmark, search_notes, list_notes, delete_note.

1. uv 설치 (1회)

PowerShell을 열고 다음을 실행하세요:

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

이후 터미널을 닫고 다시 열어 uv가 PATH에 등록되도록 하세요.

Related MCP server: MCP Notes Server

2. 프로젝트 설정

이 폴더를 영구적인 위치(예: C:\Users\<사용자명>\mcp-vault)에 압축 해제하세요. 그런 다음 폴더 내부에서:

cd C:\Users\<you>\mcp-vault
uv sync

이 명령어는 가상 환경을 생성하고 fastmcp를 설치합니다.

3. 독립 실행 테스트 (Claude Desktop 연결 전)

uv run fastmcp dev server.py

이 명령어는 브라우저에서 MCP Inspector를 엽니다. Tools 탭을 클릭하고 add_note를 호출해 텍스트를 추가한 후 list_notes를 호출하면 저장된 내용이 표시됩니다. 확인이 끝나면 Ctrl+C로 중지하세요.

4. Claude Desktop에 연결

다음 파일을 열거나 생성하세요:

%APPDATA%\Claude\claude_desktop_config.json

mcpServers 아래에 vault 항목을 추가하세요. 파일에 이미 다른 서버가 있다면 전체 파일을 덮어쓰지 말고 이 키만 함께 추가하세요.

{
  "mcpServers": {
    "vault": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "C:\\Users\\<you>\\mcp-vault",
        "fastmcp",
        "run",
        "server.py"
      ]
    }
  }
}

C:\\Users\\<사용자명>\\mcp-vault를 실제 폴더 경로로 바꾸세요 — 예시와 같이 이중 백슬래시를 사용하세요.

5. Claude Desktop 재시작

완전히 종료(트레이 아이콘 우클릭 → Quit, 창 닫기 아님)한 후 다시 실행하세요. 채팅 상자에서 도구 아이콘을 클릭하면 5개의 vault 도구가 표시됩니다.

6. 사용해보기

• "메모 저장: 여권 갱신, 태그는 todo"

• "링크 저장: https://example.com, 제목은 Example, 태그는 reference"

• "태그가 todo인 저장 내용 보기"

• "메모에서 passport 검색"

• "메모 1번 삭제"

데이터는 server.py와 같은 폴더에 있는 vault.db에 저장됩니다 — SQLite 파일이므로 SQLite 브라우저로 직접 열어 확인할 수 있습니다.

스크린샷

참고사항

• 각 도구의 docstring은 Claude가 도구 호출 시점을 결정할 때 읽는 내용입니다 — 도구 이름이나 용도를 변경할 경우 docstring도 정확하게 업데이트하세요. 이것이 전체 인터페이스입니다.

• Claude Desktop이 서버를 인식하지 못하면 %APPDATA%\Claude\logs\에서 오류를 확인하세요 — 대부분 설정 파일의 경로가 잘못된 경우입니다.