vikunja-mcp

一个远程 MCP (Model Context Protocol) 服务器，用于将 Claude 连接到您的自托管 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 的“设置 > 连接器”中：

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

请参阅 DEPLOY-UBERSPACE.md 获取在 Uberspace 上进行完整部署的指南。

配置

变量	必需	描述
`VIKUNJA_URL`	是	您的 Vikunja 实例的基础 URL（末尾不要加斜杠）
`VIKUNJA_TOKEN`	是	来自 Vikunja 设置 > API 令牌的 API 令牌
`MCP_AUTH_TOKEN`	推荐	`/mcp` 端点的共享密钥 — 请参阅 Auth
`PORT`	否	监听端口（默认：`3000`）

身份验证

当设置了 MCP_AUTH_TOKEN 时，服务器会拒绝任何未包含匹配 ?token=… 查询参数的 /mcp 请求，并返回 401 Unauthorized 响应。

生成一个强令牌：

openssl rand -hex 32

将其添加到 Claude.ai 的连接器 URL 中：

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 端点的查询参数令牌 (MCP_AUTH_TOKEN)；用于上游 API 调用的 Vikunja API 令牌
运行时： Node.js + Express
SDK： @modelcontextprotocol/sdk v1.x

要求

Node.js ≥ 18
一个带有 API 令牌的自托管 Vikunja 实例
一个可供 Claude.ai 访问的公共 URL 以连接到服务器

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Vikunja MCP Server