项目简介

Vikunja MCP服务器是一个基于Model Context Protocol构建的完整后端服务，允许AI助手通过标准化的JSON-RPC协议访问和操作Vikunja实例中的任务数据。

主要功能

任务管理：创建、读取、更新、删除任务，支持重复任务、提醒、评论和批量操作
项目管理：完整的项目CRUD操作，支持项目层次结构和分享功能
标签管理：创建和管理任务标签，支持批量应用和移除
团队协作：管理团队和团队成员
数据导入导出：支持从CSV和JSON批量导入任务
Webhook管理：为项目自动化设置事件触发器
高级过滤：使用类似SQL的查询语言进行智能任务筛选
用户管理：获取用户信息和更新用户设置
安全特性：Zod验证、DoS防护、速率限制和内存保护

安装步骤

通过NPM安装（推荐）

在您的Claude Desktop或其他MCP兼容客户端配置中添加：

{
  "vikunja": {
    "command": "npx",
    "args": ["-y", "@democratize-technology/vikunja-mcp

本地开发安装

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

然后配置MCP客户端：

{
  "vikunja": {
    "command": "node",
    "args": ["/path/to/vikunja-mcp/dist/index.js

服务器配置

在MCP客户端配置中设置以下环境变量：

VIKUNJA_URL：您的Vikunja实例的API地址（如：https://your-vikunja-instance.com/api/v1"


## 基本使用方法
1. **设置认证信息**：
   - 获取API令牌：访问Vikunja设置 → API令牌 → 创建新令牌
- **VIKUNJA_API_TOKEN**：您的API令牌（以"tk_"开头）

2. **创建任务**：
   ```json
   {
     "projectId": 1,
     "title": "我的第一个MCP任务"
   }

列出任务：

{
  "allProjects": true
}

认证方式

支持两种认证方法：

API令牌认证：标准认证方式，提供对任务、项目、标签和团队的完全访问权限

注意：用户管理功能需要JWT认证，可从浏览器开发者工具中提取。

服务器启动后，AI助手可以通过标准MCP协议调用各种工具来管理Vikunja任务。

关键词