Guarded Notes MCP

먼저 계획하세요. 한 번에 이동하세요. 안전하게 롤백하세요.

Guarded Notes MCP는 macOS에서 Apple Notes를 안전하게 검토하고 정리하기 위한 로컬 전용 Model Context Protocol 서버이자 Codex 플러그인입니다. 메모를 목록화, 검색, 읽기, 스냅샷, 계획, 이동할 수 있지만, 메모 삭제, 폴더 삭제, 메모 내용 편집은 의도적으로 할 수 없습니다.

[!IMPORTANT] 서버 자체에는 네트워크 클라이언트, 분석, 텔레메트리, 패키지 다운로드 또는 업데이트 서비스가 포함되어 있지 않습니다. MCP를 통해 반환된 메모 정보는 연결한 AI 클라이언트에 여전히 표시되므로 해당 클라이언트의 데이터 제어를 검토하세요.

이 프로젝트가 존재하는 이유

일반적인 Apple Notes 자동화 도구는 폭넓은 기능에 최적화되어 있습니다. Guarded Notes MCP는 소중한 개인 라이브러리의 통제된 정리에 최적화되어 있습니다. 쓰기 경로에는 최근 스냅샷, 정확한 만료 계획, 확인 문구, 그리고 Terminal에서 대화식으로 생성된 별도의 일회용 인증이 필요합니다. 해당 인증은 계획의 무작위 토큰, 전체 64자 다이제스트, 그리고 정확한 다이제스트 접미사가 붙은 확인 문구에 바인딩됩니다.

다른 공개 Apple Notes MCP 서버도 존재하지만, 이 릴리스에서 검토된 프로젝트들은 이 완전한 안전 시퀀스를 문서화하지 않습니다. 이는 제품 설계의 차이이지 법적 신규성 주장이 아닙니다. 기능 비교 및 출처 설명을 참조하세요.

안전 흐름

flowchart LR
    A[Apple Notes] -->|local osascript| B[Inventory]
    B --> C[Private cache + snapshot]
    C --> D[Reviewable manifest]
    D --> E[Exact expiring plan]
    E --> F[Human review]
    F --> G[Plan-bound Terminal authorization]
    G --> H[Cross-process lock + mutation epoch]
    H --> I[Verified note moves]
    I --> J[Owner-only operation journal]
    J --> K[Rollback plan]

소유자 전용 프로세스 간 변형 잠금을 획득한 후, 서버는 인증을 소비하고 첫 번째 쓰기 전에 영속화된 변형 에포크를 진행합니다. 인증은 두 번째 배치를 승인할 수 없습니다. 각 이동 직전에 서버는 메모가 여전히 예상된 소스 폴더에 있는지도 확인합니다. 적용 배치에는 225초의 마감 시간이 있으며 원자적 소유자 전용 저널을 유지합니다. 시간 초과된 변형은 성공 또는 실패로 추측하지 않고 불확실한 것으로 보고됩니다.

Codex에 설치

요구 사항:

• Apple Notes가 있는 macOS

• node로 사용 가능한 Node.js 22 이상

• Codex 또는 다른 MCP 호환 로컬 클라이언트

이 GitHub 저장소를 마켓플레이스 소스로 추가하세요:

codex plugin marketplace add nextgencods/guarded-notes-mcp --ref v1.0.0

ChatGPT 데스크톱 앱을 다시 시작하고, 플러그인 디렉토리를 열고, nextgencods 소스를 선택한 다음 Guarded Notes MCP를 설치하세요. 이 저장소는 OpenAI의 문서화된 마켓플레이스 구조를 따르며 플러그인은 plugins/guarded-notes-mcp/ 아래에 있습니다.

로컬 개발 또는 수동 설치는 설치를 참조하세요.

첫 사용

읽기 전용 요청으로 시작하세요:

내 Apple Notes를 검토하고 아무것도 변경하지 않고 조직 계획을 제안하세요.

첫 번째 호출은 로컬 Node 프로세스가 Notes를 제어하도록 허용하는 macOS 자동화 프롬프트를 트리거할 수 있습니다. 자동화 접근만 허용하세요. 전체 디스크 접근을 허용하지 마세요. 이 프로젝트는 이를 요청하거나 요구하지 않습니다.

승인된 이동 배치의 경우 계획 도구가 반환한 arm 명령을 실행하세요. 동일한 계획의 32자 토큰과 전체 64자 다이제스트를 붙여넣은 다음, 대문자 12자 다이제스트 접미사를 포함한 정확한 생성 문구를 입력하세요. 다른 계획의 값을 혼합하지 마세요.

사용하지 않은 인증은 다음으로 취소할 수 있습니다:

node plugins/guarded-notes-mcp/scripts/disarm-moves.mjs

개인정보 보호 경계

런타임 데이터는 다음 위치에 로컬로 저장됩니다:

~/Library/Application Support/Guarded Notes MCP/

파일은 소유자 전용(0600)으로 생성되고 디렉토리는 소유자 전용(0700)으로 생성됩니다. 소스 저장소에는 메모 데이터, 계정 이름, 머신 식별자, 자격 증명 또는 절대 사용자 경로가 포함되어 있지 않습니다. 전체 데이터 처리 설명은 개인정보를 참조하세요.

문서

• 설치 및 업그레이드

• 아키텍처

• 관련 프로젝트와 비교

• 출처 및 저자

• 도구 참조

• 보안 모델

• 개인정보

• 사용법

• 문제 해결

• 릴리스 프로세스

• 변경 로그

저장소 구조

.
├── .agents/plugins/marketplace.json   # Git-backed Codex marketplace
├── .github/                           # CI, releases, and community templates
├── docs/                              # Architecture and operating guides
├── plugins/guarded-notes-mcp/         # Distributable plugin
│   ├── .codex-plugin/plugin.json
│   ├── .mcp.json
│   ├── scripts/
│   ├── tests/
│   └── server.mjs
└── scripts/validate-repository.mjs    # Dependency-free release validator

기여

보안 경계는 여기서 제품 기능입니다. 삭제, 콘텐츠 편집, 네트워크 접근, 직접 데이터베이스 접근을 추가하거나 이동 게이트를 우회하는 변경은 명시적인 주요 버전 설계 결정 없이는 수락되지 않습니다.

풀 리퀘스트를 열기 전에 CONTRIBUTING.md를 읽으세요. 취약점의 경우 SECURITY.md를 따르고 공개 이슈를 제기하지 마세요.

소유권, 라이선스 및 상표

nextgencods가 만들고 유지 관리합니다. MIT 라이선스로 배포됩니다.

이 독립 프로젝트는 Apple Inc. 또는 OpenAI와 제휴, 보증 또는 후원 관계가 아닙니다. Apple, Apple Notes, macOS, OpenAI, ChatGPT 및 Codex는 각 소유자의 상표입니다. NOTICE를 참조하세요.