Obsidian Kanban MCP Server

黑曜石看板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