Obsidian Notes

🚀 Obsidian MCP 服務器

Obsidian MCP 服務器是一個輕量級的服務器，它基於 模型上下文協議 (MCP) 構建，能讓 AI 助手（像 Cursor 和 Claude 這類）對您的 Obsidian 筆記 vault 進行讀寫操作，極大地提升了筆記管理的智能化水平。

🚀 快速開始

您可以通過以下命令完成安裝與構建：

npm install obsidian-mcp-server
npm run build

要將您的 MCP 服務器與 Claude Desktop 集成，請將以下配置添加到您的 Claude 配置中：

{
  "mcpServers": {
    "obsidian": {
      "command": "node",
      "args": [
        "obsidian-mcp-server/build/index.js",
        "/path/to/your/vault"
      ]
    }
  }
}

若要與 Cursor 集成，可轉到 MCP 標籤 Cursor 設置（按 Command + Shift + J），添加一個服務器並使用以下命令：

node obsidian-mcp-server/build/index.js /path/to/your/vault

✨ 主要特性

示例交互

• 可以向服務器發出如“創建一個新筆記，描述我今天所做的代碼更改，並安排明天的站會”（還應使用 Git）這樣的指令。
• 能執行“檢查我的項目創意相關筆記”的操作。
• 支持“查看我與重構相關的待辦事項”的查詢。

工具

讀取

1. getAllFilenames
   • 功能：獲取 Obsidian 筆記 vault 中所有文件的文件名列表，方便您發現可用文件。
2. readMultipleFiles
   • 功能：從 Obsidian 筆記 vault 中檢索指定文件的內容。它支持精確文件名、部分文件名或不區分大小寫的匹配，並且會在每個文件的內容前添加 '# 文件：filename' 以明確標識。
3. getOpenTodos
   • 功能：檢索 Obsidian 筆記 vault 中所有未完成的 TODO 項。它會查找未標記的 checkbox 項目（包含 '- [ ] ' 的行），並在返回時附帶其文件位置。

寫入

1. updateFileContent
   • 功能：使用新的 Markdown 內容更新指定文件在 Obsidian 筆記 vault 中的內容。如果文件不存在，會自動創建，同時也會自動創建任何必要的目錄。

📦 安裝指南

npm install obsidian-mcp-server
npm run build

💻 使用示例

基礎用法

以下是將 MCP 服務器與 Claude Desktop 集成的配置示例：

{
  "mcpServers": {
    "obsidian": {
      "command": "node",
      "args": [
        "obsidian-mcp-server/build/index.js",
        "/path/to/your/vault"
      ]
    }
  }
}

高級用法

以下是與 Cursor 集成的命令示例：

node obsidian-mcp-server/build/index.js /path/to/your/vault

📚 詳細文檔

與其他解決方案的比較

儘管此實現故意保持輕量級，但其他解決方案如 jacksteamdev/obsidian-mcp-tools 提供了更功能豐富的 Obsidian 插件。此獨立服務器的優勢在於可以直接訪問文件系統，而無需運行 Obsidian 應用程序。

資源

• 模型上下文協議文檔
• MCP 服務器倉庫