Skip to main content
Glama
lindenlion

Vikunja MCP Server

by lindenlion

vikunja-mcp

Claudeをセルフホスト型のVikunjaインスタンスに接続するためのリモートMCP(Model Context Protocol)サーバーです。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

2つのタスクをリンク(サブタスク、ブロック、先行、関連など)

remove_relation

2つのタスク間の関連付けを削除

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の「設定」>「コネクタ」から、サーバーをカスタムコネクタとして追加します:

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

Uberspaceでの完全なデプロイ手順については、DEPLOY-UBERSPACE.mdを参照してください。

設定

変数

必須

説明

VIKUNJA_URL

はい

VikunjaインスタンスのベースURL(末尾のスラッシュは不要)

VIKUNJA_TOKEN

はい

Vikunjaの「設定」>「APIトークン」から取得したAPIトークン

MCP_AUTH_TOKEN

推奨

/mcpエンドポイント用の共有シークレット — 認証を参照

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日以内に完了したタスクが含まれます。一度購読すれば、カレンダーアプリが自動的にポーリングを行います。

アーキテクチャ

  • トランスポート: ストリーミング可能な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

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers