Сервер Model Context Protocol (MCP), который позволяет ассистентам ИИ взаимодействовать с экземплярами управления задачами Vikunja.

Особенности

• Инструменты на основе подкоманды для интуитивно понятных взаимодействий с ИИ
• Аутентификация на основе сессий с автоматическим управлением токенами
• Реализованы операции полного управления задачами
• Полное управление проектом с использованием CRUD операций
• Управление этикетками для организации задач
• Командные операции для совместной работы (get/update/members ограничены API)
• Управление пользователями с настройками и поиском
• Управление вебхуками для автоматизации проектов
• Пакетный импорт задачи из CSV или JSON-файлов
• Проверка ввода для дат, идентификаторов и шестнадцатикратных цветов
• Эффективные обновления на основе дифференциальных систем для присваиваемых
• TypeScript с строгим режимом для безопасности шрифта
• Комплексная обработка ошибок с типизированными ошибками и централизованными утилитами
• Готовая к производству логика повтора с автоматическим выключателем опоссума для устойчивости
• Усиленная безопасность с помощью проверки входных данных на основе Zod и защиты DoS
• Защита с ограничением скорости от DoS-атак с настраиваемыми ограничениями
• Защита памяти с ограничениями страницирования и мониторингом использования

Vikunja MCP Server

A Model Context Protocol (MCP) server that enables AI assistants to interact with Vikunja task management instances.

Features

• Subcommand-based tools for intuitive AI interactions
• Session-based authentication with automatic token management
• Full task management operations implemented
• Complete project management with CRUD operations
• Label management for organizing tasks
• Team operations for collaboration (get/update/members limited by API)
• User management with settings and search
• Webhook management for project automation
• Batch import tasks from CSV or JSON files
• Input validation for dates, IDs, and hex colors
• Efficient diff-based updates for assignees
• TypeScript with strict mode for type safety
• Comprehensive error handling with typed errors and centralized utilities
• Production-ready retry logic with opossum circuit breaker for resilience
• Enhanced security with Zod-based input validation and DoS protection
• Rate limiting protection against DoS attacks with configurable limits
• Memory protection with pagination limits and usage monitoring
• Simplified architecture with 90% code reduction for maintainability

🚀 Major Architectural Improvements (v0.2.0)

This release represents a massive architectural simplification that eliminates technical debt while enhancing security and reliability:

Storage Architecture Refactoring (90% Code Reduction)

• Before: 33 files, 9,803 lines of over-engineered storage system
• After: 4 files, essential functionality only
• Eliminated: Complex orchestrators, health monitors, statistics tracking, migration systems
• Result: Same external API with dramatically improved maintainability

Zod-Based Filter System (850+ Lines Removed)

• Before: Custom tokenizer, parser, and validator with security vulnerabilities
• After: Secure Zod schema validation with production-ready parsing
• Enhanced: DoS protection, input sanitization, and comprehensive error handling
• Result: Faster parsing, better security, and enterprise-grade reliability

Production-Ready Retry System (580+ Lines Replaced)

• Before: Custom retry logic with maintenance overhead
• After: Battle-tested opossum circuit breaker library
• Features: Circuit breaker state sharing, automatic recovery, comprehensive monitoring
• Result: Production resilience with battle-tested patterns

Zero Breaking Changes

All improvements maintain 100% backward compatibility with existing implementations while providing enhanced reliability and security.

Requirements

• Node.js 20+ (LTS versions only)
• Vikunja instance with API access
• API token (starting with tk_) or JWT token for authentication

Installation

Option 1: Install from NPM (Recommended)

The easiest way to use vikunja-mcp is through npx in your Claude Desktop or other MCP-compatible client configuration: