Nextcloud MCP Server
2025.05.06
0
PythonNextcloud 集成笔记管理自动化工具交流协作
Nextcloud MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，允许大型语言模型（如 OpenAI 的 GPT、Google 的 Gemini 或 Anthropic 的 Claude）与 Nextcloud 实例进行交互。该服务主要用于自动化 Nextcloud 的各种操作，目前主要支持 Nextcloud Notes API。
View on GitHub
Overview
基本能力
产品定位
Nextcloud MCP Server 是一个中间件服务，用于连接大型语言模型（LLMs）和 Nextcloud 实例，实现自动化操作。
核心功能
- 与 Nextcloud Notes API 交互，管理笔记。
- 提供工具和资源，支持创建、更新和删除笔记。
适用场景
- 自动化管理 Nextcloud 笔记。
- 通过 LLMs 与 Nextcloud 实例交互，提高工作效率。
工具列表
nc_notes_create_note: 创建新笔记。nc_notes_update_note: 通过 ID 更新现有笔记。nc_notes_delete_note: 通过 ID 删除笔记。
资源列表
notes://{note_id}: 通过 ID 访问特定笔记。notes://all: 访问所有笔记。notes://settings: 访问笔记设置。nc://capabilities: 访问 Nextcloud 服务器能力。
常见问题解答
- 如何配置 Nextcloud 实例？
需要在
.env文件中配置NEXTCLOUD_HOST、NEXTCLOUD_USERNAME和NEXTCLOUD_PASSWORD。 - 推荐使用哪种密码？ 推荐使用 Nextcloud App Password，以提高安全性。
使用教程
使用依赖
- Python 3.8+
- 访问 Nextcloud 实例
安装教程
- 克隆仓库（如果从源代码运行）：
bash git clone https://github.com/cbcoutinho/nextcloud-mcp-server.git cd nextcloud-mcp-server - 安装包（如果作为库运行）：
bash poetry install
Docker 安装
使用预构建的 Docker 镜像：
docker run -p 127.0.0.1:8000:8000 --env-file .env --rm ghcr.io/cbcoutinho/nextcloud-mcp-server:latest
调试方式
- 加载环境变量：
bash export $(grep -v '^#' .env | xargs) - 运行服务器：
bash mcp run --transport sse nextcloud_mcp_server.server:mcp - 使用
uvx客户端连接服务器：bash uvx mcp add nextcloud-mcp http://localhost:8000 --default-transport sse