看板管理服务器

一个用于管理Obsidian看板的MCP服务器,支持列和任务的增删改查以及看板创建。

  • by trung-persefoni
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 trung-persefoni/obsidian-kanban-mcp

使用说明

黑曜石看板MCP服务器

用于管理黑曜石看板的MCP服务器。

特性

  • 列出金库中的所有看板。
  • 阅读板内容(列和任务)。
  • 将任务添加到特定列。
  • 在列之间移动任务。
  • 创建新的看板。

用法

先决条件

  • 已安装Node.js。
  • 黑曜石拱顶 看板插件 安装。

配置

服务器指向由指定的黑曜石保管库 VAULT_PATH 环境变量。 如果未设置,则默认为 ~/workspace/cursor-vault.

您还可以选择设置:

  • OBSIDIAN_BOARD_NAME 默认板文件名(例如。, MyBoard.md).如果已设置,则不需要提供 board_name 争论。

建筑

npm install
npm run build

跑步

node dist/index.js

MCP工具

  • list_boards:列出所有板。
  • get_board_content(board_name):获取列和任务。
  • add_task(board_name, column_name, task_text, description?, labels?, acceptance_criteria?, create_note?):添加具有可选详细信息的任务。
    • description:任务详细信息的多行字符串。
    • labels:字符串数组(例如。, ["urgent", "bug"]).作为标签附加到标题上。
    • acceptance_criteria:字符串数组。作为清单添加在描述中。
    • create_note:布尔值。默认为 true。如果为真,则创建一个包含详细信息的新Markdown注释,并将其链接到板上。设置为 false 将所有细节保存在卡上。
  • move_task(board_name, task_text, from_column, to_column):移动任务。
  • create_board(board_name, columns):创建新板。

部署和集成

与Claude Desktop集成

将以下内容添加到您的 claude_desktop_config.json (MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "obsidian-kanban": {
      "command": "node",
      "args": ["/path/to/mcp-obsidian-kanban/dist/index.js"],
      "env": {
        "VAULT_PATH": "/path/to/your/obsidian/vault",
        "OBSIDIAN_BOARD_NAME": "MyBoard.md"
      }
    }
  }
}

与Cursor集成

  1. 首选 光标设置 > 特性 > 主控程序.
  2. 点击 +添加新的MCP服务器.
  3. 填写详细信息:
    • 名字:黑曜石看板
    • 类型音频:
    • 命令: node /path/to/mcp-obsidian-kanban/dist/index.js
    • 环境变量: VAULT_PATH=/path/to/your/obsidian/vault;OBSIDIAN_BOARD_NAME=MyBoard.md