Obsidian Tasks MCP

🚀 Obsidian Tasks MCP 服務器

這是一個獨立的 Go 語言 MCP 服務器，它能夠從你的 Obsidian 保險庫中的 Markdown 文件裡解析任務，並在不依賴 REST API 的情況下評估核心任務查詢過濾器。

本服務器實現了 Obsidian Tasks 插件 中部分查詢過濾器的功能。完整的查詢語法和示例請參考 Tasks 插件文檔。

🚀 快速開始

安裝

使用 go install 命令

go install github.com/hairyhenderson/obsidian-tasks-mcp@latest

從源代碼安裝

git clone https://github.com/hairyhenderson/obsidian-tasks-mcp.git
cd obsidian-tasks-mcp
go install .

使用方法

服務器通過標準輸入/輸出運行，並使用 MCP 協議進行通信。它接受一個或多個根目錄作為命令行參數：

obsidian-tasks-mcp -root /path/to/vault -root /path/to/other/vault

MCP 工具：query_tasks

服務器提供了一個名為 query_tasks 的 MCP 工具，它接受以下參數：

• query（字符串，可選）：帶有過濾器的任務查詢字符串（每行一個過濾器）。支持的過濾器和語法請參考 Tasks 插件查詢文檔。
• rootDirs（字符串數組，必需）：用於掃描 Markdown 文件的根目錄。

該工具會返回一個任務對象數組，包含 id、description、status、filePath、lineNumber、tags 和 dueDate 字段。

為 Cursor 進行配置

將以下內容添加到你的 Cursor MCP 設置中（通常是 ~/.cursor/mcp.json 或類似文件）：

{
  "mcpServers": {
    "obsidian-tasks": {
      "command": "obsidian-tasks-mcp",
      "args": [
        "-root",
        "/path/to/your/obsidian/vault"
      ]
    }
  }
}

你可以指定多個根目錄：

{
  "mcpServers": {
    "obsidian-tasks": {
      "command": "obsidian-tasks-mcp",
      "args": [
        "-root",
        "/path/to/vault1",
        "-root",
        "/path/to/vault2"
      ]
    }
  }
}

開發

運行測試

make test

代碼檢查

make lint

📄 許可證

本項目採用 MIT 許可證。完整的許可證文本請查看 LICENSE 文件。

版權所有 (c) 2026 Dave Henderson