Skip to main content
Glama
lindenlion

Vikunja MCP Server

by lindenlion

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

Удалить связь между двумя задачами

Related MCP server: vikunja-mcp

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

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 мог связаться с сервером

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers