适合谁
- 希望将 AI 助手（如 Claude Desktop 或 IDE）与自托管的 Nextcloud 实例集成的用户。
- 需要跨多个 Nextcloud 应用进行深度 CRUD 操作的开发者和高级用户。
- 需要 Docker 或 Kubernetes 部署的团队。
N
67FMRS · C
Nextcloud MCP Server 是一个功能丰富的 MCP 服务器，为 Nextcloud 提供了广泛的 API 覆盖，支持多种认证和部署方式。它适合需要将 AI 助手与 Nextcloud 深度集成的用户，但需要谨慎处理凭据，并注意其并非官方项目。
Nextcloud MCP Server 是一个独立的 MCP 服务器，让 Claude、GPT 等大语言模型能够通过安全的 API 与您的 Nextcloud 数据交互。它提供 110 多个 MCP 工具，覆盖 10 多个 Nextcloud 应用，包括笔记、日历、联系人、文件（WebDAV）、Deck、Cookbook、表格、共享、新闻、邮件、集合并与 Talk。该服务器支持多种认证模式（单用户基本认证、多用户基本认证、登录流程 v2），并支持多种部署方式（Docker、Kubernetes、虚拟机、本地）。它还提供了实验性的语义搜索功能（基于 RAG），用于对笔记、文件、新闻、卡片和邮件进行向量搜索。
工具能力
notes.*
Notes 应用的完整 CRUD 操作、关键词搜索和语义搜索。
calendar.*
日历事件、任务、重复事件、参与者、可用性管理。
contacts.*
完整的 CardDAV 支持，地址簿管理。
files.*
文件系统访问、OCR、文档处理（PDF、DOCX、图片）。
deck.*
看板、堆栈、卡片、标签、分配的管理。
cookbook.*
食谱管理，支持 URL 导入（schema.org）。
tables.*
对 Nextcloud Tables 进行行操作。
sharing.*
创建和管理共享。
news.*
管理订阅源、文件夹、条目，监控订阅源健康。
mail.*
邮箱账号、文件夹、消息、附件、发送、标记、移动、删除。
collectives.*
对群组、页面和标签的完整 CRUD 操作。
talk.*
列出会话、读取/发布消息、标记为已读、列出参与者。
semantic_search.*
对笔记、文件、新闻、卡片和邮件进行向量搜索（实验性，需额外基础设施）。
安装接入
- 使用 pipx 或源安装，或使用 Docker。2. 设置环境变量 NEXTCLOUD_HOST、NEXTCLOUD_USERNAME 和 NEXTCLOUD_PASSWORD（建议使用应用密码）。3. 使用
uvx nextcloud-mcp-server run --transport stdio运行，或使用 Docker 镜像 ghcr.io/cbcoutinho/nextcloud-mcp-server:latest。4. 将命令或 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"
}
}
}
}
选型与风险
不适合谁
- 不希望自行管理的用户（可考虑托管服务 Astrolabe Cloud）。
- 仅需要简单只读访问的用户（此服务器更侧重于完整操作）。
- 需要官方支持的用户（它不是 Nextcloud 官方项目）。
所需权限
- 需要 Nextcloud 用户名和应用程序密码（或 OAuth）。
- 对所选 Nextcloud 应用（笔记、日历、联系人、文件等）的读写访问。
- 对于语义搜索，需要外部服务：Qdrant 和 Ollama（默认禁用）。
风险与副作用
- 使用应用程序密码存储凭据，可能存在泄露风险。
- 用户提供的凭据可以访问其 Nextcloud 账户的完整数据，应谨慎管理。
- 实验性语义搜索依赖于外部服务，可能引入安全和数据隐私问题。
- 标签排除功能（EXCLUDED_TAGS）依赖系统标签来隐藏敏感文件，误配可能导致数据暴露。
常见排障
- 检查环境变量是否正确设置。
- 确保 Nextcloud 实例可通过网络访问。
- 验证应用密码是否正确生成。
- 对于语义搜索，检查 Qdrant 和 Ollama 服务是否正在运行且可访问。
- 查看文档中的故障排除指南（docs/troubleshooting.md）。
使用场景
通过自然语言创建和管理笔记、日历事件和联系人。
搜索和处理文件，包括 OCR 和文档提取。
管理 Deck 看板、Cookbook 食谱和表格。
通过 Talk 与团队协作并共享文件。
在 Nextcloud 内容上进行语义搜索（实验性）。
支持客户端
Claude Desktop完整支持