Nextcloud MCP Server

社区

将 AI 助手连接到您的 Nextcloud 实例的生产级 MCP 服务器。

分类: 云存储第 2 / 15
Stars: ★ 380 非常热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Docker · Python
凭据: 需要 API Key / 凭据
许可证: AGPL-3.0
最近提交: 2 天前
工具数: 13

67FMRS · C

Nextcloud MCP Server 是一个功能丰富的 MCP 服务器，为 Nextcloud 提供了广泛的 API 覆盖，支持多种认证和部署方式。它适合需要将 AI 助手与 Nextcloud 深度集成的用户，但需要谨慎处理凭据，并注意其并非官方项目。

最强项 · 文档质量 16/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

12/20

维护活跃度

16/20

文档质量

16/20

安装易用性

13/20

查看各项评分依据

可靠性 10/20: 代码库结构完整，包含大量工具定义和测试，但缺少可验证的CI工作流和关键路径测试证据，因此可靠性评分受限。
安全与权限 12/20: 采用应用密码和OAuth登录流程，提供标签排除敏感文件，但未发现对危险操作的明确确认机制，且凭据处理细节不透明。
维护活跃度 16/20: 项目活跃，有频繁提交和发布，提供安全响应渠道，许可证明确（AGPL-3.0），但未提供治理或版本策略细节。
文档质量 16/20: 文档层次丰富，覆盖安装、配置、认证和故障排除，但可能缺少某些限制和成本披露。
安装易用性 13/20: 提供多种部署方式（uvx、Docker、Kubernetes），客户端配置示例清晰，但依赖外部服务可能增加安装复杂度。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件访问网络连接数据库

适合谁

希望将 AI 助手（如 Claude Desktop 或 IDE）与自托管的 Nextcloud 实例集成的用户。
需要跨多个 Nextcloud 应用进行深度 CRUD 操作的开发者和高级用户。
需要 Docker 或 Kubernetes 部署的团队。

不适合谁

不希望自行管理的用户（可考虑托管服务 Astrolabe Cloud）。
仅需要简单只读访问的用户（此服务器更侧重于完整操作）。
需要官方支持的用户（它不是 Nextcloud 官方项目）。

所需权限

需要 Nextcloud 用户名和应用程序密码（或 OAuth）。
对所选 Nextcloud 应用（笔记、日历、联系人、文件等）的读写访问。
对于语义搜索，需要外部服务：Qdrant 和 Ollama（默认禁用）。

风险与副作用

使用应用程序密码存储凭据，可能存在泄露风险。
用户提供的凭据可以访问其 Nextcloud 账户的完整数据，应谨慎管理。
实验性语义搜索依赖于外部服务，可能引入安全和数据隐私问题。
标签排除功能（EXCLUDED_TAGS）依赖系统标签来隐藏敏感文件，误配可能导致数据暴露。

安装接入

准备工作

运行环境：Docker · Python

NEXTCLOUD_HOST 必填你的 Nextcloud 实例的完整 URL，例如 https://your.nextcloud.instance.com。

NEXTCLOUD_USERNAME 必填你的 Nextcloud 用户名。

NEXTCLOUD_PASSWORD 必填密钥 Nextcloud 应用密码，在 Settings > Security > Devices & sessions 中生成，勿用登录密码。

其他可选配置项（2 个）

EXCLUDED_TAGS 可选可选；配置 Nextcloud 系统标签，用于从 MCP 文件工具中隐藏带该标签的敏感文件/文件夹。

ENABLE_SEMANTIC_SEARCH 可选可选；启用实验性语义搜索（默认 false），需要 Qdrant 和 Ollama。

使用 pipx 或源安装，或使用 Docker。
设置环境变量 NEXTCLOUD_HOST、NEXTCLOUD_USERNAME 和 NEXTCLOUD_PASSWORD（建议使用应用密码）。
使用 uvx nextcloud-mcp-server run --transport stdio 运行，或使用 Docker 镜像 ghcr.io/cbcoutinho/nextcloud-mcp-server:latest。
将命令或 HTTP 端点添加到 MCP 客户端配置中。

claude_desktop_config.json

{
  "mcpServers": {
    "nextcloud": {
      "command": "uvx",
      "args": [
        "nextcloud-mcp-server",
        "run",
        "--transport",
        "stdio"
      ],
      "env": {
        "NEXTCLOUD_HOST": "https://your.nextcloud.instance.com",
        "NEXTCLOUD_USERNAME": "your_username",
        "NEXTCLOUD_PASSWORD": "your_app_password"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "nextcloud": {
      "command": "uvx",
      "args": [
        "nextcloud-mcp-server",
        "run",
        "--transport",
        "stdio"
      ],
      "env": {
        "NEXTCLOUD_HOST": "https://your.nextcloud.instance.com",
        "NEXTCLOUD_USERNAME": "your_username",
        "NEXTCLOUD_PASSWORD": "your_app_password"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add nextcloud -e NEXTCLOUD_HOST=https://your.nextcloud.instance.com -e NEXTCLOUD_USERNAME=your_username -e NEXTCLOUD_PASSWORD=your_app_password -- uvx nextcloud-mcp-server run --transport stdio

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 MCP 客户端配置中添加该服务器并启动，工具列表中应出现 notes.*、calendar.* 等工具；然后让 AI 列出你的 Nextcloud 笔记，能返回真实内容即证明连接成功。

常见排障

检查环境变量是否正确设置。
确保 Nextcloud 实例可通过网络访问。
验证应用密码是否正确生成。
对于语义搜索，检查 Qdrant 和 Ollama 服务是否正在运行且可访问。
查看文档中的故障排除指南（docs/troubleshooting.md）。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

在我的 Nextcloud 笔记里新建一篇笔记，标题叫“会议记录”。
列出我 Nextcloud 日历下周的所有日程。
在我的 WebDAV 文件中搜索包含“发票”的文件。
给 Jane 发一封邮件，主题是“项目更新”。

工具能力 13

notes.* 写入

Notes 应用的完整 CRUD 操作、关键词搜索和语义搜索。

calendar.* 写入

日历事件、任务、重复事件、参与者、可用性管理。

contacts.* 写入

完整的 CardDAV 支持，地址簿管理。

files.* 写入

文件系统访问、OCR、文档处理（PDF、DOCX、图片）。

deck.* 写入

看板、堆栈、卡片、标签、分配的管理。

cookbook.* 写入

食谱管理，支持 URL 导入（schema.org）。

tables.* 写入

对 Nextcloud Tables 进行行操作。

sharing.* 写入

创建和管理共享。

展开其余 5 个工具

news.* 写入

管理订阅源、文件夹、条目，监控订阅源健康。

mail.* 破坏性

邮箱账号、文件夹、消息、附件、发送、标记、移动、删除。

collectives.* 写入

对群组、页面和标签的完整 CRUD 操作。

talk.* 写入

列出会话、读取/发布消息、标记为已读、列出参与者。

semantic_search.* 只读

对笔记、文件、新闻、卡片和邮件进行向量搜索（实验性，需额外基础设施）。

使用场景

通过自然语言创建和管理笔记、日历事件和联系人。

搜索和处理文件，包括 OCR 和文档提取。

管理 Deck 看板、Cookbook 食谱和表格。

通过 Talk 与团队协作并共享文件。

在 Nextcloud 内容上进行语义搜索（实验性）。

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

Nextcloud MCP Server 是一个独立的 MCP 服务器，让 Claude、GPT 等大语言模型能够通过安全的 API 与您的 Nextcloud 数据交互。它提供 110 多个 MCP 工具，覆盖 10 多个 Nextcloud 应用，包括笔记、日历、联系人、文件（WebDAV）、Deck、Cookbook、表格、共享、新闻、邮件、集合并与 Talk。该服务器支持多种认证模式（单用户基本认证、多用户基本认证、登录流程 v2），并支持多种部署方式（Docker、Kubernetes、虚拟机、本地）。它还提供了实验性的语义搜索功能（基于 RAG），用于对笔记、文件、新闻、卡片和邮件进行向量搜索。