vikunja-mcp

Name: vikunja-mcp
Author: AnthonyUtt

本地服务

github.com/AnthonyUtt生产力022 周前更新

代码仓库

关于 vikunja-mcp

vikunja-mcp 是用于与 Vikunja 待办应用交互的基础 MCP 服务。它支持项目和任务操作；新建任务仅支持标题、描述和完成状态字段。

主要功能

01列出项目并按 ID 获取项目
02列出所有任务或项目内任务
03添加含标题、描述和完成状态的任务
04更新任务
05删除任务

适用场景

01查看项目及其任务
02向项目添加任务
03更新或删除任务

MCP 相关

通过 MCP 服务提供 Vikunja 项目和任务操作。MCP 客户端可列出、添加、更新和删除任务，并获取项目信息。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "vikunja-mcp-anthonyutt": {
      "command": "npx",
      "args": [
        "-y",
        "vikunja-mcp"
      ],
      "env": {
        "VIKUNJA_API_BASE": "<VIKUNJA_API_BASE>",
        "VIKUNJA_API_TOKEN": "<VIKUNJA_API_TOKEN>"
      }
    }
  }
}

启动命令npx -y vikunja-mcp

需要配置的环境变量

VIKUNJA_API_BASE

VIKUNJA_API_TOKEN密钥

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmvikunja-mcpstdio

工具

收录的工具列表 · 更新于 3 周前

此工具无需参数。

详细介绍

vikunja-mcp

Vikunja 的基础 MCP 服务，未来可能会添加更多功能

当前支持的功能

列出项目
按 ID 获取项目
列出所有任务
列出项目中的任务
向项目添加任务
- 注意：仅支持标题、描述和完成状态字段
更新任务
删除任务

安装

通过 npx：

{
    "mcpServers": {
        // ... other config
        "vikunja": {
            "command": "npx",
            "args": [
                "-y",
                "vikunja-mcp"
            ],
            "env": [
                "VIKUNJA_API_BASE": "https://app.vikunja.cloud",
                "VIKUNJA_API_TOKEN": "<your_token_here>"
            ]
        }
    }
}

或本地构建：

git clone https://github.com/AnthonyUtt/vikunja-mcp && cd vikunja-mcp
pnpm install
pnpm build

然后，在 Claude 配置中：

{
    "mcpServers": {
        // ... other config
        "vikunja": {
            "command": "node",
            "args": [
                "/path/to/dist/index.js"
            ],
            "env": [
                "VIKUNJA_API_BASE": "https://app.vikunja.cloud",
                "VIKUNJA_API_TOKEN": "<your_token_here>"
            ]
        }
    }
}

支持 Markdown

登录后评论