MCP Nextcloud カレンダー

Nextcloud カレンダー統合用のモデル コンテキスト プロトコル (MCP) サーバー。

特徴

• Nextcloudからカレンダーを取得する

• ADHDに優しい整理機能

• MCP プロトコルのサポート (ストリーミング可能な HTTP およびレガシー HTTP+SSE)

Related MCP server: ical-mcp

使用法

npx での使用

このパッケージを使用する最も簡単な方法は npx を使用することです。

npx mcp-nextcloud-calendar

インストール

開発またはローカルインストールの場合:

# Install globally
npm install -g mcp-nextcloud-calendar

# Or install locally
npm install mcp-nextcloud-calendar

MCP クライアント構成

MCP クライアント (Claude など) で使用するには、次の構成を MCP クライアント設定に追加します。

{
  "mcpServers": {
    "nextcloud-calendar": {
      "command": "npx",
      "args": ["-y", "mcp-nextcloud-calendar"],
      "env": {
        "NEXTCLOUD_BASE_URL": "https://your-nextcloud-server.com",
        "NEXTCLOUD_USERNAME": "your-username",
        "NEXTCLOUD_APP_TOKEN": "your-app-token"
      }
    }
  }
}

バージョンの指定

パッケージの特定のバージョンに固定することができます。

{
  "mcpServers": {
    "nextcloud-calendar": {
      "command": "npx",
      "args": ["-y", "mcp-nextcloud-calendar@0.1.0"],
      "env": {
        "NEXTCLOUD_BASE_URL": "https://your-nextcloud-server.com",
        "NEXTCLOUD_USERNAME": "your-username",
        "NEXTCLOUD_APP_TOKEN": "your-app-token"
      }
    }
  }
}

構成

環境変数

サーバーは、可能な場合はデフォルトを使用して、次の環境変数を使用します。

開発セットアップ

地域開発の場合:

1. リポジトリをクローンする

2. 依存関係をインストールします:

npm install

3. プロジェクト ルートに.envファイルを作成します。

cp .env.example .env

4. Nextcloud の資格情報を使用して.envファイルを編集します。

Nextcloudアプリトークンの取得

1. Nextcloudインスタンスにログインする

2. 「設定」→「セキュリティ」→「アプリパスワード」へ移動します。

3. 「MCPカレンダー」のような名前で新しいアプリパスワードを作成します

4. 生成されたトークンを.envファイルにコピーします。

発達

# Build the project
npm run build

# Run in development mode
npm run dev

# Run tests
npm run test

# Run linting
npm run lint

# Format code
npm run format

APIエンドポイント

• /mcp - プライマリ MCP エンドポイント (ストリーミング可能な HTTP トランスポート)

• /sseおよび/messages - レガシー MCP エンドポイント (HTTP+SSE トランスポート)

• GET /health - ヘルスチェックエンドポイント

• GET /api/calendars - すべてのカレンダーを一覧表示する

MCPツール

次の MCP ツールが登録されており、クライアントが利用できます。

カレンダー管理

⚠️ 権限に関する警告： updateCalendarおよびdeleteCalendarツールは、Nextcloudインスタンスで特別な権限を必要とする場合があります。カレンダーの操作はNextcloudの権限システムに従います。

イベント管理

既知の問題と制限事項

注意：このパッケージは現在開発初期段階（0.1.x）です。APIとツールは将来のリリースで予告なく変更される可能性があります。

• カレンダーの更新と削除の操作には、Nextcloudインスタンスでの特定の権限が必要になる場合があります。

• 特定のNextcloudエラーコードに対するエラー処理はまだ改善中です

• 多くのイベントを含む大きなカレンダーではパフォーマンスの問題が発生する可能性があります

問題が発生した場合は、GitHub リポジトリに報告してください。

ライセンス

ISC