AIquila — Nextcloud MCP Server

AIquila MCP 服务

MCP（Model Context Protocol）服务，让任何 MCP 客户端都能全面访问你的 Nextcloud 实例，包括文件、日历、任务、联系人、邮件、Talk、地图、书签、笔记、投票、表单等。涵盖 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 客户端）

有关如何将 AIquila 作为 HTTP 服务运行，并通过 OAuth 服务于 Claude.ai 等远程 MCP 客户端，请参阅 Docker 设置指南。

这会使用哪个 AI 模型？

不使用任何模型。此服务没有自带模型，也没有提供商设置——它会将你的 Nextcloud 暴露给你连接的任何 MCP 客户端，而该客户端会使用自己的模型。 提供商选择（Claude、Hetzner Inference、Mistral、本地模型、DeepSeek）属于 AIquila Nextcloud 应用，这是一个独立组件。

功能

核心功能（始终可用）

类别	工具
文件	15
共享	10
应用	6
标签	6
用户状态	5
用户	4
群组	4
通知	4
状态	3
缺席	3
回收站	3
搜索	2
版本	2
活动	2
小计	69

AIquila 应用

类别	工具
项目	7
协作	15
AIquila	3
安全	2
OCC	1
小计	25

可选 Nextcloud 应用

类别	工具
地图	40
社交	26
表单	25
投票	21
新闻	17
书签	13
Deck	12
照片	11
邮件	10
Talk	10
Circles	8
日历	6
任务	6
联系人	6
食谱	6
笔记	5
文本	5
服务条款	5
助手	4
公告	3
Passman	3
注册	3
翻译	1
社交分享	1
推荐	1
小计	248

总计：345 个工具。

配置

变量	必填	说明
NEXTCLOUD_URL	是	自动移除末尾的斜杠
NEXTCLOUD_USER	是
NEXTCLOUD_PASSWORD	是	使用 App 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+
• 一个设置了 App Password 的 Nextcloud 实例

可选的 Nextcloud 应用可解锁其他类别的工具：Tasks、Calendar、Contacts、Notes、Cookbook、Deck、Bookmarks、Mail、Maps、Photos、Talk、Circles 等。

文档

• 设置指南 — 详细的安装和配置说明
• 工具参考 — 完整的工具目录
• 架构 — 设计和内部实现
• 完整文档 — 完整文档索引

支持

AIquila 是免费软件。如果它对你有帮助，可以通过 GitHub Sponsors 或 Liberapay 资助其开发。

许可证

MIT — 属于 AIquila 项目 的一部分。