AI导哈

任务管理服务

一个为开源任务管理应用Vikunja提供的MCP服务器，支持通过Claude Code或任何MCP兼容客户端管理项目、任务和标签。

  • by jrejaud
  • TypeScript
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 jrejaud/vikunja-mcp

使用说明

mcp

MCP服务器 维昆贾，开源任务管理应用程序。提供16个工具，用于通过Claude Code或任何兼容MCP的客户端管理项目、任务和标签。

设置

环境变量

变量 必填 描述
VIKUNJA_URL 是 您的Vikunja实例URL（例如。， https://vikunja.example.com)
VIKUNJA_API_TOKEN 是 来自Vikunja设置>API令牌的API令牌

Claude代码配置

增添 ~/.claude.json:

{
  "mcpServers": {
    "vikunja": {
      "command": "npx",
      "args": ["-y", "vikunja-mcp"],
      "env": {
        "VIKUNJA_URL": "https://vikunja.example.com",
        "VIKUNJA_API_TOKEN": "tk_your_token_here"
      }
    }
  }
}

或者从本地克隆运行：

{
  "mcpServers": {
    "vikunja": {
      "command": "node",
      "args": ["/path/to/vikunja-mcp/dist/index.js"],
      "env": {
        "VIKUNJA_URL": "https://vikunja.example.com",
        "VIKUNJA_API_TOKEN": "tk_your_token_here"
      }
    }
  }
}

工具（16）

项目

  • vikunja_list_项目 --列出所有项目
  • vikunja_create_项目 --创建项目（支持通过嵌套 parent_project_id)
  • vikunja_更新_项目 --更新项目标题、描述、存档状态
  • vikunja_delete项目 --删除项目及其所有任务

任务

  • vikunja_list_tasks --列出所有项目中的任务（搜索、筛选、排序、分页）
  • vikunja_list_项目任务 --列出特定项目中的任务
  • vikunja_get-task --获取完整的任务详细信息
  • vikunja_create_task --在项目中创建任务
  • vikunja_update_task --更新任务字段
  • vikunja_完成任务 --将任务标记为已完成
  • vikunja_delete_task --删除任务
  • 维昆贾_创造_任务 --一次创建多个任务

标签

  • vikunja_list_labels --列出所有标签
  • vikunja_create_label --创建具有可选颜色的标签
  • vikunja_add_label_to_totask --为任务分配标签
  • vikunja_remove_label_from_task --从任务中删除标签

从源代码构建

git clone https://github.com/jrejaud/vikunja-mcp.git
cd vikunja-mcp
npm install
npm run build

API注释

此MCP包装 Vikunja REST API v1.一些怪癖：

  • Vikunja使用 PUT用于创建 和 POST以获取更新 （与典型的REST相反）
  • 在项目中列出任务需要一个视图ID——MCP通过获取第一个视图来自动处理这个问题
  • 日期使用ISO 8601格式： 2026-03-15T00:00:00Z
  • API令牌可以在Vikunja中的“设置”>“API令牌”下创建

许可证

麻省理工学院

相关 MCP