Vault

安装配置

{
    "mcpServers": {
        "obsidian": {
            "command": "npx",
            "args": [
                "@bitbonsai/mcpvault@latest",
                "/path/to/your/vault"
            ]
        }
    }
}

README 摘要

# MCPVault A universal AI bridge for Obsidian vaults using the Model Context Protocol (MCP) standard. Connect any MCP-compatible AI assistant to your knowledge base - works with Claude, ChatGPT, and future AI tools. This server provides safe read/write access to your notes while preventing YAML frontmatter corruption. [https://mcpvault.org](https://mcpvault.org) [Changelog](./CHANGELOG.md) [](https://github.com/bitbonsai/mcpvault) [](https://www.npmjs.com/package/@bitbonsai/mcpvault) [](https://www.npmjs.com/package/@bitbonsai/mcpvault) [](https://github.com/sponsors/bitbonsai) [](https://ko-fi.com/bitbonsai) [](https://liberapay.com/bitbonsai/) ## Universal Compatibility Works with any MCP-compatible AI assistant including Claude Desktop, Claude Code, ChatGPT Desktop (Enterprise+), OpenCode, Gemini CLI, OpenAI Codex, IntelliJ IDEA 2025.1+, Cursor IDE, Windsurf IDE, and future AI platforms that adopt the MCP standard. https://github.com/user-attachments/assets/657ac4c6-1cd2-4cc3-829f-fd095a32f71c ## Quick Start (5 minutes) 1. **Install Node.js runtime:** ```bash # Download from https://nodejs.org (v18.0.0 or later) # or use a package manager like nvm, brew, apt, etc. ``` 2. **Test the server:** If using the published package: ```bash npx @modelcontextprotocol/inspector npx @bitbonsai/mcpvault@latest /path/to/your/vault ``` 3. **Configure your AI client:** **Claude Desktop** - Copy this to `claude_desktop_config.json`: ```json { "mcpServers": { "obsidian": { "command": "npx", "args": ["@bitbonsai/mcpvault@latest", "/path/to/your/vault"] } } } ``` **Claude Code** - Copy this to `~/.claude.json`: ```json { "mcpServers": { "obsidian": { "command": "npx", "args": ["@bitbonsai/mcpvault@latest", "/path/to/your/vault"], "env": {} } } } ``` **OpenCode** - Copy this to `~/.config/opencode/opencode.json` ```json { "mcp": { "obsidian": { "type": "local", "command": [ "npx", "@bitbonsai/mcpvault@latest", "/path/to/your/vault/" ], "enabled": true } } } ``` Replace `/path/to/your/vault` with your actual Obsidian vault path. For other platforms, see [detailed configuration guides](#ai-client-configuration) below. 4. **Test with your AI:** - "List files in my Obsidian vault" - "Read my note called 'project-ideas.md'" - "Create a new note with today's date" **Success indicators:** Your AI should be able to list files and read...