Obsidian MCP

🚀 Obsidian MCP 服務器

一個 MCP（模型上下文協議） 服務器，讓 AI 助手能夠與 Obsidian 筆記庫進行交互，提供了讀取、創建、編輯和管理筆記及標籤的工具，極大提升筆記管理效率。

🚀 快速開始

此 MCP 服務器可使 AI 助手與 Obsidian 筆記庫交互。在使用前，請確保滿足相關要求，並依據安裝步驟完成配置。

✨ 主要特性

• 🔍 讀取和搜索筆記
• 📝 創建新筆記和目錄
• ✏️ 編輯現有筆記
• 🚚 移動和刪除筆記
• 🏷️ 管理標籤（添加、移除、重命名）
• 🔎 搜索 vault 內容

📦 安裝指南

手動安裝

將以下內容添加到您的 Claude Desktop 配置中：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
    "mcpServers": {
        "obsidian": {
            "command": "npx",
            "args": ["-y", "obsidian-mcp", "/path/to/your/vault", "/path/to/your/vault2"]
        }
    }
}

將 /path/to/your/vault 替換為您 Obsidian 筆記庫的絕對路徑。例如： macOS/Linux:

"/Users/username/Documents/MyVault"

Windows:

"C:\\Users\\username\\Documents\\MyVault"

保存配置後重新啟動 Claude，您應該會看到錘子圖標出現，表示服務器已連接。

如果遇到連接問題，請檢查日誌：

• macOS: ~/Library/Logs/Claude/mcp*.log
• Windows: %APPDATA%\Claude\logs\mcp*.log

通過 Smithery 安裝

注意：我與 Smithery 無關。我尚未測試過使用它，建議用戶儘量手動安裝。

要通過 Smithery 自動為 Claude Desktop 安裝 Obsidian：

npx -y @smithery/cli install obsidian-mcp --client claude

🔧 技術細節

要求

• Node.js 20 或更高版本（可能在更低版本上運行，但尚未測試）
• Obsidian 筆記庫

開發

# 克隆倉庫
git clone https://github.com/StevenStavrakis/obsidian-mcp
cd obsidian-mcp

# 安裝依賴項
npm install

# 構建
npm run build

然後將以下內容添加到您的 Claude Desktop 配置中：

{
    "mcpServers": {
        "obsidian": {
            "command": "node",
            "args": ["dist/index.js"],
            " cwd ": "."
        }
    }
}

可用工具

• obsidian-mcp start: 啟動 MCP 服務器
• obsidian-mcp stop: 停止 MCP 服務器
• obsidian-mcp status: 檢查 MCP 服務器狀態

📄 許可證

本項目採用 MIT 許可證。

⚠️ 重要提示

此 MCP 具有讀寫權限（如果您允許）。請在使用 obsidian-mcp 管理筆記之前，備份您的 Obsidian 筆記庫。我建議使用 git，但任何備份方法都可以。這些工具已經過測試，但尚未徹底測試，並且此 MCP 正處於積極開發中。

💡 使用建議

• 備份您的 Obsidian 筆記庫在使用此工具之前。
• 確保 Node.js 版本符合要求。