生产级的 Nextcloud MCP 服务器，提供 90+ 工具让 AI 助手直接操作 Nextcloud 中的文件、笔记、日历和看板，支持 Docker/Kubernetes 部署。
Nextcloud MCP Server 是一个基于 Python 的高性能中间件，通过 Model Context Protocol (MCP) 赋能 AI 助手（如 Claude、GPT、Gemini）深度集成 Nextcloud 生产力平台。
核心价值#
该项目解决了 AI 无法安全、便捷地访问私有云数据的问题。用户无需暴露 Nextcloud 的完整管理权限，只需配置一次连接，AI 即可获得读写特定应用数据的能力。
功能特性#
应用支持（8 大应用，90+ 工具）#
| 应用 | 工具数 | 核心能力 |
|---|---|---|
| Notes | 7 | 完整 CRUD、关键词搜索、语义搜索 |
| Calendar | 20+ | 事件/待办、循环事件、参与者管理、可用性查询 |
| Files (WebDAV) | 12 | 文件系统访问、OCR/文档处理 |
| Deck | 15 | 看板、堆栈、卡片、标签、分配 |
| Contacts | 8 | CardDAV 支持、地址簿管理 |
| Cookbook | 13 | 食谱管理、URL 导入 (schema.org) |
| Tables | 5 | Nextcloud Tables 行操作 |
| Sharing | 10+ | 创建和管理共享 |
高级特性#
- 语义搜索（实验性）：基于向量的相似度搜索，支持 Notes、Files、News items、Deck cards
- 文档处理：PDF/DOCX/图像的 OCR 和文本提取（PyMuPDF + Pillow）
- 多传输协议：SSE、HTTP、streamable-http
- 可观测性：Prometheus 指标、OpenTelemetry 集成
典型用例#
- 笔记管理：「创建一个名为'会议记录'的笔记，包含今天的议程」
- 食谱导入：「从 https://example.com/recipe 导入食谱」
- 日程管理：「安排下周二下午2点的团队会议」
- 文件操作：「创建文件夹'项目 X'，并将所有 PDF 移动到那里」
- 语义搜索：「查找与机器学习相关的笔记」
部署方式#
Docker（推荐）#
docker run -p 127.0.0.1:8000:8000 --env-file .env \
ghcr.io/cbcoutinho/nextcloud-mcp-server:latest
本地安装#
uv pip install nextcloud-mcp-server
认证配置#
- 推荐：Basic Auth + App Password（生产就绪）
- 实验性：OAuth2/OIDC（需修补 user_oidc 应用）
关键技术栈#
- Python >= 3.11
- MCP Python SDK, Starlette (ASGI), httpx
- Pydantic v2, SQLite + Alembic
- Qdrant, FastEmbed, BM25（语义搜索）
项目成熟度#
- 1900+ commits, 323 tags, 当前版本 0.64.3
- 完整测试套件 + CI/CD (GitHub Actions)
- 22+ 架构决策记录 (ADR)
- 开源协议：AGPL-3.0-only