AIquila — Nextcloud MCP Server

AIquila MCP Server

あらゆる MCP クライアントに Nextcloud インスタンスへの完全なアクセスを提供する MCP（Model Context Protocol）サーバーです。ファイル、カレンダー、タスク、連絡先、メール、トーク、マップ、ブックマーク、ノート、投票、フォームなどを利用できます。44 カテゴリーにわたる 345 個のツールを備えています。

クイックスタート

Stdio トランスポート（ローカル MCP クライアント）

MCP クライアントの設定に追加します。Claude Desktop の設定例（~/.config/claude/claude_desktop_config.json）を示します。Claude Code、Cursor、VS Code でも、各自の設定ファイルで同じサーバー定義を使用します。

{
	"mcpServers": {
		"aiquila": {
			"command": "npx",
			"args": ["-y", "aiquila-mcp"],
			"env": {
				"NEXTCLOUD_URL": "https://your-nextcloud.example.com",
				"NEXTCLOUD_USER": "your-username",
				"NEXTCLOUD_PASSWORD": "your-app-password"
			}
		}
	}
}

Nextcloud でアプリパスワードを生成します：設定 → セキュリティ → デバイスとセッション。

HTTP トランスポート（Docker、リモート MCP クライアント）

Claude.ai などのリモート MCP クライアント向けに、AIquila を OAuth 対応の HTTP サーバーとして実行する方法については、Docker セットアップガイドをご覧ください。

使用する AI モデルは何ですか？

モデルは使用しません。このサーバーには独自のモデルもプロバイダー設定もありません。指定した MCP クライアントに Nextcloud を公開し、モデルはそのクライアントが用意します。プロバイダー（Claude、Hetzner Inference、Mistral、ローカルモデル、DeepSeek）の選択は、別のコンポーネントであるAIquila Nextcloud アプリで行います。

できること

コア（常に利用可能）

カテゴリー	ツール
ファイル	15
共有	10
アプリ	6
タグ	6
ユーザーステータス	5
ユーザー	4
グループ	4
通知	4
ステータス	3
不在	3
ゴミ箱	3
検索	2
バージョン	2
アクティビティ	2
小計	69

AIquila アプリ

カテゴリー	ツール
プロジェクト	7
Cowork	15
AIquila	3
セキュリティ	2
OCC	1
小計	25

オプションの Nextcloud アプリ

カテゴリー	ツール
マップ	40
ソーシャル	26
フォーム	25
投票	21
ニュース	17
ブックマーク	13
Deck	12
写真	11
メール	10
トーク	10
サークル	8
カレンダー	6
タスク	6
連絡先	6
Cookbook	6
ノート	5
Text	5
利用規約	5
アシスタント	4
お知らせ	3
Passman	3
登録	3
翻訳	1
ソーシャル共有	1
おすすめ	1
小計	248

合計：345 個のツール。

設定

変数	必須	備考
NEXTCLOUD_URL	はい	末尾のスラッシュは自動的に削除されます
NEXTCLOUD_USER	はい
NEXTCLOUD_PASSWORD	はい	アプリパスワードを使用してください
MCP_TRANSPORT	いいえ	stdio（デフォルト）または http
MCP_AUTH_ENABLED	いいえ	true にすると、リモートクライアント向けの OAuth が有効になります
MCP_AUTH_SECRET	認証時	openssl rand -hex 32
MCP_AUTH_ISSUER	認証時	このサーバーのパブリック HTTPS URL
MCP_AUTH_STATE_DIR	いいえ	永続化された OAuth 状態の保存先ディレクトリ（デフォルトは /app/state）
MCP_LAZY_AUTH	いいえ	false にすると、すべての JSON-RPC メソッドでベアラートークンが必要です（デフォルトは true）
MCP_LOCALE	いいえ	get_local_time 用の BCP 47 ロケールタグ（例：sv-SE）。デフォルトはシステムのロケールです
MCP_MAX_FILE_SIZE	いいえ	write_file のコンテンツの最大長（バイト単位、デフォルトは 1073741824 = 1 GB）
MCP_ALLOWED_HOSTS	いいえ	DNS リバインディング保護に追加するホスト名
MCP_CORS_ORIGINS	いいえ	CORS で許可する追加のブラウザーオリジン
MCP_OCC_ALLOWLIST	いいえ	run_occ で許可する OCC コマンド。デフォルトの許可リストを上書きします
LOG_LEVEL	いいえ	trace／debug／info／warn／error／fatal

要件

• Node.js 26+
• アプリパスワードを設定した Nextcloud インスタンス

Nextcloud のオプションアプリを利用すると、Tasks、Calendar、Contacts、Notes、Cookbook、Deck、Bookmarks、Mail、Maps、Photos、Talk、Circles などのツールカテゴリが追加されます。

ドキュメント

• セットアップガイド — インストールと設定の詳細
• ツールリファレンス — ツールの全カタログ
• アーキテクチャ — 設計と内部構造
• ドキュメント全文 — ドキュメントの完全な索引

サポート

AIquila はフリーソフトウェアです。役に立った場合は、 GitHub Sponsors または Liberapay を通じて開発を支援できます。

ライセンス

MIT — AIquila プロジェクトの一部です。