MCP Obsidian Planner

mcp黑曜石规划师

采用GTD+PARA方法的黑曜石保险库规划MCP服务器。

17个工具，用于每日笔记、收件箱、任务、项目、每周评论和全文搜索。

入门指南 · 工具 · 建筑 · 配置

______________________________________________________________________

它的作用

将Claude Code（或任何MCP客户端）直接连接到您的黑曜石保险库进行结构化规划：

• 每日笔记 --从模板创建，设置前3个焦点，跟踪任务
• 收件箱 --捕捉想法，确定优先级，将项目处理到项目/领域中
• 任务 --列出、添加、切换任何笔记或文件夹
• 项目 --创建PARA区域，跟踪状态和截止日期
• 每周评论 --自动生成完成率摘要
• 搜索 --使用上下文在vault中进行全文搜索

与合作 LifeOS vault结构使用Templater模板和Dataview兼容的frontmatter。

______________________________________________________________________

入门指南

先决条件

• Node.js>=18
• 具有文件夹结构的黑曜石保险库（请参见 拱顶结构)

安装

git clone https://github.com/jarero321/mcp-obsidian-planner.git
cd mcp-obsidian-planner
npm install
npm run build

配置Claude代码

增添 ~/.claude/settings.json:

{
  "mcpServers": {
    "obsidian-planner": {
      "command": "node",
      "args": ["/path/to/mcp-obsidian-planner/dist/main.js"],
      "env": {
        "VAULT_PATH": "/path/to/your/obsidian/vault"
      }
    }
  }
}

配置Claude桌面

增添 claude_desktop_config.json:

{
  "mcpServers": {
    "obsidian-planner": {
      "command": "node",
      "args": ["/path/to/mcp-obsidian-planner/dist/main.js"],
      "env": {
        "VAULT_PATH": "/path/to/your/obsidian/vault"
      }
    }
  }
}

验证

# Test with MCP Inspector
npm run inspect

# Or run directly
npm run start:stdio

______________________________________________________________________

工具

每日笔记（3）

收件箱（4）

任务（3）

每周评论（2）

搜索和注释（3）

项目（2）

______________________________________________________________________

建筑

使用NestJS依赖注入的干净架构：

src/
├── domain/                  # Entities, enums, value objects
│   ├── entities/            # Task, Note, DailyNote, Project, InboxItem, WeeklyReview
│   ├── enums/               # TaskStatus, ProjectStatus, InboxPriority, Area
│   └── value-objects/       # VaultPath (path traversal protection), DateRange
│
├── application/             # Business logic
│   ├── ports/               # Abstractions (VaultRepository, NoteParser, TemplateEngine, Logger)
│   └── use-cases/           # 17 use cases organized by domain
│       ├── daily/           # CreateDaily, GetDaily, SetDailyFocus
│       ├── inbox/           # ListInbox, AddInbox, ProcessInbox, PrioritizeInbox
│       ├── tasks/           # ListTasks, ToggleTask, AddTask
│       ├── weekly/          # WeeklySummary, CreateWeekly
│       ├── search/          # VaultSearch, ReadNote, ListNotes
│       └── projects/        # ListProjects, CreateProject
│
├── infrastructure/          # Concrete implementations
│   ├── vault/               # File system operations (fs/promises)
│   ├── parser/              # Markdown + frontmatter parsing (gray-matter)
│   ├── template/            # Templater syntax replacement (dayjs)
│   ├── logging/             # stderr JSON logger (stdout reserved for MCP)
│   └── mcp/                 # MCP server, handlers, presenter, tool definitions
│
└── config/                  # Vault configuration module

端口和适配器

______________________________________________________________________

配置

环境变量

复制 .env.example 到 .env 并调整路径：

cp .env.example .env

运输方式

# stdio (default) — for Claude Code / Claude Desktop
node dist/main.js

# SSE — for web clients
node dist/main.js --sse
# Runs on PORT (default: 3000)

______________________________________________________________________

拱顶结构

预期黑曜石拱顶布局：

Vault/
├── 00-Dashboard/          # Central hub with Dataview queries
├── 01-Inbox/
│   └── Inbox.md           # GTD inbox with priority sections
├── 02-Proyectos/          # Active projects with frontmatter
├── 04-Areas/              # PARA areas (Salud, Carrera, Finanzas, etc.)
├── 06-Archive/            # Archived items
├── 07-Daily/              # Daily notes (YYYY-MM-DD.md)
└── Templates/             # Templater templates
    ├── Daily Template.md
    ├── Weekly Review.md
    └── Proyecto Template.md

收件箱格式

## Captura Rápida
- [ ] Some task _2025-01-15 10:30_
- Some note _2025-01-15 11:00_

## Urgente (hacer esta semana)
- [ ] Important task _2025-01-15 09:00_

## Puede esperar
## Algún día / Quizás
## Notas Rápidas

项目负责人

---
estado: En progreso
area: Carrera
inicio: 2025-01-01
deadline: 2025-03-01
objetivo: Build the thing
---

______________________________________________________________________

技术栈

Runtime          Node.js 18+
Framework        NestJS 11 (application context, no HTTP)
MCP SDK          @modelcontextprotocol/sdk 1.12
Parsing          gray-matter (YAML), regex (tasks, sections)
Dates            dayjs (Templater replacement)
Validation       Zod (tool input schemas)
Architecture     Clean Architecture, Ports & Adapters

______________________________________________________________________

脚本

______________________________________________________________________

许可证

麻省理工学院