vikunja-mcp

Удаленный MCP-сервер (Model Context Protocol), который подключает Claude к вашему self-hosted экземпляру Vikunja. Добавьте его как пользовательский коннектор в Claude.ai и управляйте своими задачами в ходе беседы.

Доступные инструменты

Инструмент	Описание
`list_projects`	Список всех проектов
`get_project`	Получить детали проекта
`create_project`	Создать новый проект
`update_project`	Обновить проект
`delete_project`	Удалить проект
`list_tasks`	Список/фильтрация/поиск задач во всех проектах
`get_task`	Получить детали задачи, включая комментарии
`create_task`	Создать задачу в проекте
`update_task`	Обновить свойства задачи
`delete_task`	Удалить задачу
`complete_task`	Отметить задачу как выполненную
`reopen_task`	Отметить задачу как невыполненную
`add_comment`	Добавить комментарий к задаче
`list_labels`	Список всех меток
`create_label`	Создать новую метку
`add_label_to_task`	Прикрепить метку к задаче
`remove_label_from_task`	Удалить метку из задачи
`weekly_review`	Создать сводку еженедельного отчета
`get_calendar`	Просмотр повестки дня с задачами, имеющими сроки (просроченные + предстоящие)
`create_relation`	Связать две задачи (подзадача, блокировка, предшествование, связь и т.д.)
`remove_relation`	Удалить связь между двумя задачами

Быстрый старт

npm install
npm run build

export VIKUNJA_URL=https://your-vikunja-instance.example.com
export VIKUNJA_TOKEN=your-api-token
export MCP_AUTH_TOKEN=$(openssl rand -hex 32)
export PORT=9090

node build/index.js

Затем добавьте свой сервер как пользовательский коннектор в Claude.ai в разделе Settings > Connectors:

https://your-server.example.com/mcp?token=<MCP_AUTH_TOKEN>

См. DEPLOY-UBERSPACE.md для полного руководства по развертыванию на Uberspace.

Конфигурация

Переменная	Обязательно	Описание
`VIKUNJA_URL`	Да	Базовый URL вашего экземпляра Vikunja (без слеша в конце)
`VIKUNJA_TOKEN`	Да	API-токен из настроек Vikunja > API Tokens
`MCP_AUTH_TOKEN`	Рекомендуется	Общий секрет для эндпоинта `/mcp` — см. Auth
`PORT`	Нет	Порт для прослушивания (по умолчанию: `3000`)

Аутентификация

Когда установлен MCP_AUTH_TOKEN, сервер отклоняет любой запрос к /mcp, который не включает соответствующий параметр запроса ?token=…, возвращая ответ 401 Unauthorized.

Сгенерируйте надежный токен:

openssl rand -hex 32

Добавьте его в URL коннектора в Claude.ai:

https://your-server.example.com/mcp?token=<your-token>

Если MCP_AUTH_TOKEN не задан, эндпоинт открыт для всех, кто имеет к нему доступ — делайте это только в частной, защищенной брандмауэром сети.

Календарная лента

Сервер предоставляет машиночитаемую ленту iCal, на которую можно подписаться в любом календарном приложении:

webcal://your-server.example.com/calendar.ics

Она включает все открытые задачи и задачи, выполненные за последние 30 дней, у которых есть дата начала, срок выполнения или дата окончания. Подпишитесь один раз, и ваше календарное приложение будет опрашивать её автоматически.

Архитектура

Транспорт: Streamable HTTP (без сохранения состояния) — текущий стандарт MCP для удаленных серверов
Аутентификация: Токен в параметре запроса (MCP_AUTH_TOKEN) для эндпоинта MCP; API-токен Vikunja для исходящих вызовов API
Среда выполнения: Node.js + Express
SDK: @modelcontextprotocol/sdk v1.x

Требования

Node.js ≥ 18
Self-hosted экземпляр Vikunja с API-токеном
Общедоступный URL, чтобы Claude.ai мог связаться с сервером

Vikunja MCP Server

vikunja-mcp

Доступные инструменты

Быстрый старт

Конфигурация

Аутентификация

Календарная лента

Архитектура

Требования

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API