aimbitgmbh/vikunja-mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

12 stars 7 forks 质量 81 趋势 28MIT

Repository Install

使用 Vikunja 2.6+ API v2 支持用于任务管理和项目管理的 MCP 服务器

概览

一个用于Vikunja任务管理和项目管理的MCP服务器. 它通过稳定的/api/v2 API将AI助手和其他模式上下文协议客户端连接到Vikunja 2.6+. 1.0.0版本经过测试,以进行可靠的MCP工具选择. 服务器仍保持模型独立,并与任何符合标准的MCP客户端合作. - 51个具有一致复数资源名称的有重点的MCP工具 - 任务、项目、标签、评论、受让人、关系和批量更新 - 保存过滤器、通知、项目视图和kanban桶 - 服务器侧搜索、过滤、排序、扩展和页码 - 结构化的JSON结果加上可读文本,用于广泛的客户端兼容性 - 破坏任务、项目、标签和通知删除默认禁用 - Vikunja API v2 合同验证和 TypeScript 输入验证 - Node.js 20.18.1或更新 - Vikunja 2.6.0或更新 - 一个Vikunja API 令牌,有你使用的工具所需的许可在Vikunja创建一个标志.

概述（AI 翻译）

一个用于Vikunja任务管理和项目管理的MCP服务器. 它通过稳定/api/v2API将AI助手和其他"模型背景协议"客户端连接到Vikunja 2.6+.

1.0.0版本用QQwen 3.8 27B**进行测试,以进行可靠的MCP工具选择. 服务器仍保持模型独立,并与任何符合标准的MCP客户端合作.

□ 特性

52个具有一致复数资源名称的有重点的MCP工具
任务、项目、标签、评论、受让人、关系和批量更新
保存过滤器、通知、项目视图和坎班桶
服务器侧搜索、过滤、排序、扩展和页码
结构化的JSON结果外加可读文本,用于广泛的客户端兼容性
破坏性任务、项目、标签和通知删除默认已禁用
Vikunja API v2合同验证和TypeScript输入验证

□ 要求

节点20.18.1或更新
Vikunja 2.6.0或更新
Vikunja API 令牌,有您使用的工具所需的权限

在 Vikunja 中根据 Settings — API Tokens 创建一个标志. 优先使用涵盖工作流程的最窄权限.

□ 安装和配置

软件包可以直接通过npx:

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

Vikunja MCP Server – MCP for Vikunja Task Management

An MCP server for Vikunja task management and project management. It connects AI assistants and other Model Context Protocol clients to Vikunja 2.6+ through the stable /api/v2 API.

Version 1.0.0 is tested with Qwen 3.8 27B for reliable MCP tool selection. The server remains model-independent and works with any standards-compliant MCP client.

Features

52 focused MCP tools with consistent plural resource names
Tasks, projects, labels, comments, assignees, relations, and bulk updates
Saved filters, notifications, project views, and kanban buckets
Server-side search, filtering, sorting, expansion, and pagination
Structured JSON results plus readable text for broad client compatibility
Destructive task, project, label, and notification deletion disabled by default
Vikunja API v2 contract validation and TypeScript input validation

Requirements

Node.js 20.18.1 or newer
Vikunja 2.6.0 or newer
A Vikunja API token with the permissions needed for the tools you use

Create a token in Vikunja under Settings → API Tokens. Prefer the narrowest permissions that cover your workflow.

Install and configure

The package can run directly through npx:

{
  "mcpServers": {
    "vikunja": {
      "command": "npx",
      "args": ["-y", "@aimbitgmbh/[email protected]"],
      "env": {
        "VIKUNJA_URL": "https://vikunja.example.com",
        "VIKUNJA_API_TOKEN": "your-api-token"
      }
    }
  }
}

VIKUNJA_URL may be the instance root, /api/v1, or /api/v2; the server normalizes it to /api/v2.

To install it globally instead:

npm install --global @aimbitgmbh/[email protected]
vikunja-mcp

Configuration

Variable	Required	Default	Purpose
`VIKUNJA_URL`	Yes	—	Vikunja instance URL
`VIKUNJA_API_TOKEN`	Yes	—	Vikunja API token
`VERIFY_SSL`	No	`true`	Verify the TLS certificate
`VIKUNJA_REQUEST_TIMEOUT_MS`	No	`30000`	HTTP timeout in milliseconds
`ENABLE_TASK_DELETE`	No	`false`	Allow permanent task deletion
`ENABLE_PROJECT_DELETE`	No	`false`	Allow permanent project deletion
`ENABLE_LABEL_DELETE`	No	`false`	Allow permanent label deletion
`ENABLE_NOTIFICATION_DELETE_ALL`	No	`false`	Allow deletion of all notifications

在 GitHub 查看完整 README

安装

npx -y @aimbitgmbh/[email protected]

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "vikunja": {
      "command": "npx",
      "args": ["-y", "@aimbitgmbh/[email protected]"],
      "env": {
        "VIKUNJA_URL": "https://vikunja.example.com",
        "VIKUNJA_API_TOKEN": "your-api-token"
      }
    }
  }
}