vikunja-mcp

概述

Vikunja MCP 服务器是一个强大的实现，使 AI 助手能够与 Vikunja 任务管理系统交互。它提供广泛的功能，包括任务管理、项目操作、标签管理、团队协作、Web 自动化和批量导入能力。最近的 v0.2.0 版本带来了重大的架构改进，代码量减少了 90%，通过基于 Zod 的验证增强了安全性，并使用 opossum 断路器模式实现了生产就绪的重试逻辑。

试试问 AI

装完之后，这里有 7 个你可以让 AI 做的事：

• vikunja_auth

  Manages authentication with Vikunja instance via API tokens or JWT

  试试:Connect to my Vikunja instance with API token试试:Check if I'm authenticated to Vikunja试试:Disconnect from Vikunja
• vikunja_tasks

  Manages task operations including create, read, update, delete, and bulk operations

  试试:List all my tasks with high priority试试:Create a new task with due date tomorrow试试:Update task 123 to mark as done
• vikunja_projects

  Manages project operations including create, read, update, delete, and hierarchy

  试试:List all my projects试试:Create a new project called 'Q4 Planning'试试:Update project 5 with a new description
• vikunja_labels

  Manages label operations for task organization

  试试:List all available labels试试:Create a new label called 'urgent'试试:Update label 3 with color '#FF0000'
• vikunja_teams

  Manages team operations including create, read, update, and member management

  试试:List all teams in my organization试试:Create a new team called 'Developers'试试:Update team 5 with a new description
• vikunja_users

  Manages user operations including search, settings, and profile updates (JWT only)

  试试:Find users with name 'John'试试:Get user settings for user 5试试:Update user profile for user 8
• vikunja_webhooks

  Manages webhook operations for project automation

  试试:List all webhooks for project 5试试:Create a new webhook for task updates试试:Update webhook 7 with a new URL
• vikunja_batch_import

  Imports tasks in bulk from CSV or JSON formats

  试试:Import tasks from this CSV file试试:Bulk create tasks from JSON data试试:Validate import without creating tasks
• vikunja_export_project

  Exports project data including tasks and child projects (JWT only)

  试试:Export project 5 with all its data试试:Export project 5 including all child projects试试:Get JSON data for project 8

可对比工具

安装

{
  "vikunja": {
    "command": "npx",
    "args": ["-y", "@democratize-technology/vikunja-mcp"],
    "env": {
      "VIKUNJA_URL": "https://your-vikunja-instance.com/api/v1",
      "VIKUNJA_API_TOKEN": "your-api-token"
    }
  }
}

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

FAQ

支持哪些认证方法？

该服务器支持 API 令牌（以 'tk_' 开头）和 JWT 令牌。API 令牌提供对任务、项目、标签、团队和 Webhook 的完全访问权限，而 JWT 令牌启用额外的用户管理和导出功能。

如何获取 JWT 令牌进行认证？

在 Web 浏览器中登录您的 Vikunja 实例，打开开发者工具（F12），转到应用程序/存储标签页，在本地存储中的 Vikunja 域下找到 JWT 令牌，然后复制整个值。

系统要求是什么？

Node.js 20+（仅限 LTS 版本）和具有 API 访问权限的 Vikunja 实例。该服务器在 v0.2.0 中经历了重大的架构改进，代码量减少了 90%，并增强了安全功能。

vikunja-mcp 对比