vikunja-mcp

Claudeをセルフホスト型のVikunjaインスタンスに接続するためのリモートMCP（Model Context Protocol）サーバーです。Claude.aiのカスタムコネクタとして追加することで、会話形式でタスクを管理できます。

利用可能なツール

クイックスタート

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を参照してください。

設定

認証

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