Storage Abstraction Layer
Unified interface for saving notes across different storage backends
Storage Selection
function get_storage_backend() {
config = Read("km-config.json")
return config?.storage?.primary || "local"
}
🛑 MCP 도구 우선 사용 규칙 (CRITICAL)
┌─────────────────────────────────────────────────────┐
│ 🛑 CRITICAL: MCP 도구 사용 강제 │
│ │
│ MCP 도구가 사용 가능한 환경에서는 반드시 MCP 사용! │
│ │
│ ❌ 잘못된 예: │
│ - write_to_file("vault/note.md", content) │
│ │
│ ✅ 올바른 예: │
│ - mcp_obsidian_create_note(path, content) │
└─────────────────────────────────────────────────────┘
Backend Mapping (Antigravity/Gemini CLI)
| Feature | Obsidian | Notion | Local |
|---|
| Create | mcp_obsidian_create_note | mcp_notion_API-post-page | write_to_file |
| Search | mcp_obsidian_search_vault | mcp_notion_API-post-search | N/A |
| Read | mcp_obsidian_read_note | mcp_notion_API-get-block-children | read_file |
| Path format | Relative to vault | Database/Page ID | File system path |
| Wikilinks | Supported | Converted to mentions | Supported |
참고: Antigravity는 MCP 도구 이름에 싱글 언더스코어(_)를 사용합니다.
MCP 도구 사용 가이드 (Obsidian)
| 작업 | 도구명 | 설명 |
|---|
| 노트 생성 | mcp_obsidian_create_note | 새 노트 생성 |
| 노트 검색 | mcp_obsidian_search_vault | Vault 내 키워드 검색 |
| 노트 읽기 | mcp_obsidian_read_note | 노트 내용 읽기 |
| 노트 목록 | mcp_obsidian_list_notes | 폴더 내 노트 목록 |
Unified Save Function
// Antigravity/Gemini CLI용 (싱글 언더스코어 사용)
function save_note(relativePath, content) {
backend = get_storage_backend()
config = Read("km-config.json")
switch (backend) {
case "obsidian":
// ⚠️ 반드시 MCP 도구 사용!
return mcp_obsidian_create_note({
path: relativePath,
content: content
})
case "notion":
return mcp_notion_API_post_page({
parent: { page_id: config.storage.notion.parentPageId },
properties: { title: [{ text: { content: getTitle(relativePath) } }] }
})
case "local":
default:
fullPath = `${config.storage.local.outputPath}/${relativePath}`
return write_to_file(fullPath, content)
}
}
Path Normalization
function normalize_path(path) {
// Windows backslash → forward slash
path = path.replace(/\\/g, '/')
// Remove leading slash for relative paths
path = path.replace(/^\//, '')
return path
}
Verification (CRITICAL)
After every save operation:
□ Did the tool actually execute? (no JSON-only output!)
□ Did we receive a success response?
□ Verify with Glob that file exists
