Nextcloud Agent

MCP运维云端

提供方 Knuckles-Team

运维云端 stdio · 本地进程 OAuth 授权 社区 / 第三方
查看接入方式

Nextcloud代理服务是一个自托管Nextcloud实例的MCP服务器和A2A代理,用于管理文件、日历、联系人和共享。

一句话选型结论

按资料字段整理

Nextcloud Agent 属于运维云端类 MCP 服务器,stdio · 本地进程,OAuth 授权,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式stdio · 本地进程 鉴权OAuth 授权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 18 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量18暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

文件管理Python本地部署日历管理联系人管理共享管理自托管

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
docker run -e CMD=nextcloud-agent -p 9016:9016 nextcloud-agent

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Docker,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 18 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 18 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Nextcloud Agent当前 18 stdio · 本地进程 本地部署 有 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Knuckles-Team上游标注的维护方 Knuckles-Team
分类运维云端本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Docker本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

12.7 KB
来自项目仓库与上游目录的原文,未做删改

Nextcloud-A2A · AG-UI · MCP

版本:0.11.0

概述

Nextcloud MCP服务器+A2A服务器

它包括一个模型上下文协议(MCP)服务器和一个现成的Agent2Agent(A2A)代理

与您的自托管Nextcloud实例交互,通过MCP服务器管理文件、日历、联系人和共享!

此存储库正在积极维护中-欢迎投稿!

支持:

  • 文件操作:列表、读取、写入、移动、复制、删除、创建文件夹、获取属性
  • 共享:列出共享、创建共享、删除共享
  • 日历:列出日历、列出事件、创建事件
  • 联系人:列出通讯簿、列出联系人、创建联系人
  • 用户信息:获取当前用户详细信息

主控程序

MCP工具

函数名称 描述 标签
list_files 列出特定路径下的文件和目录。 files
read_file 读取文本文件的内容。 files
write_file 将文本内容写入文件。 files
create_folder 创建一个新目录。 files
delete_item 删除文件或目录。 files
move_item 移动文件或目录。 files
copy_item 复制文件或目录。 files
get_properties 获取文件或文件夹的详细属性。 files
list_shares 列出所有股份。 sharing
create_share 创建新共享(用户、组、链接、电子邮件)。 sharing
delete_share 删除共享。 sharing
list_calendars 列出可用日历。 calendar
list_calendar_events 在日历中列出事件。 calendar
create_calendar_event 创建日历事件。 calendar
list_address_books 列出地址簿。 contacts
list_contacts 在通讯簿中列出联系人。 contacts
create_contact 创建新联系人。 contacts
get_user_info 获取当前用户的信息。 user

用作MCP服务器

MCP服务器可以在两种模式下运行: stdio (用于本地测试)或 http (用于网络访问)。要启动服务器,请使用以下命令:

在stdio模式下运行(默认):```bash

nextcloud-agent --transport "stdio"


#### 在HTTP模式下运行:```bash
nextcloud-agent --transport "http"  --host "0.0.0.0"  --port "8016"

AI提示:```text
List all files in my 'Documents' folder.


AI回应:```text
Contents of 'Documents':
[FILE] Project_Proposal.docx (Size: 15403, Modified: Sun, 01 Feb 2026 10:00:00 GMT)
[FILE] Notes.txt (Size: 450, Modified: Sun, 01 Feb 2026 09:30:00 GMT)
[DIR] Financials (Size: -, Modified: Fri, 30 Jan 2026 14:20:00 GMT)

A2A代理

此软件包还包括一个A2A代理服务器,可用于与Nextcloud MCP服务器交互。

架构:```mermaid


config:
layout: dagre


flowchart TB
subgraph subGraph0["Agent Capabilities"]
C["Agent"]
B["A2A Server - Uvicorn/FastAPI"]
D["MCP Tools"]
F["Agent Skills"]
end
C --> D & F
A["User Query"] --> B
B --> C
D --> E["Nextcloud API"]

C:::agent
B:::server
A:::server
classDef server fill:#f9f,stroke:#333
classDef agent fill:#bbf,stroke:#333,stroke-width:2px
style B stroke:#000000,fill:#FFD600
style D stroke:#000000,fill:#BBDEFB
style F fill:#BBDEFB
style A fill:#C8E6C9
style subGraph0 fill:#FFF9C4


### 组件交互图```mermaid
sequenceDiagram
participant User
participant Server as A2A Server
participant Agent as Agent
participant Skill as Agent Skills
participant MCP as MCP Tools

User->>Server: Send Query
Server->>Agent: Invoke Agent
Agent->>Skill: Analyze Skills Available
Skill->>Agent: Provide Guidance on Next Steps
Agent->>MCP: Invoke Tool
MCP-->>Agent: Tool Response Returned
Agent-->>Agent: Return Results Summarized
Agent-->>Server: Final Response
Server-->>User: Output

图形架构

此代理使用 pydantic-graph 智能路由和最佳上下文管理的编排。```mermaid

title: Nextcloud Agent Graph Agent

stateDiagram-v2
[] --> RouterNode: User Query
RouterNode --> DomainNode: Classified Domain
RouterNode --> [
]: Low confidence / Error
DomainNode --> [*]: Domain Result


- **路由器节点**:快速、轻便的LLM(例如。, `nvidia/nemotron-3-super`)它将用户的查询分类到一个专门的域中。
- **域节点**:执行器节点。对于所选域,它动态设置环境变量,以暂时仅启用与该域相关的工具,从而创建高度集中的子代理(例如。, `gpt-4o`)以完成请求。这保留了LLM上下文并防止了工具幻觉。

## 用法

### MCP-CLI

|短旗|长旗|描述|
|------------|------------------------------------|-----------------------------------------------------------------------------|
|-h|--help|显示帮助信息|
|-t |--transport |传输方法:“stdio”、“http”或“sse”\遗留\|
|-s|--host|HTTP传输的主机地址(默认值:0.0.0.0)|
|-p|--port|HTTP传输的端口号(默认值:8016)|
||--auth-type|身份验证类型:“none”、“static”、“jwt”、“oauth代理”、“oidc代理”和“remote oauth”(默认值:none)|
||--令牌jwks-uri |用于JWT验证的jwks uri|
||--代币发行人| JWT验证发行人|
||--令牌受众|JWT验证的受众|
||--oauth上游授权端点|oauth代理的上游授权端点|
||--oauth上游令牌端点|oauth代理的上游令牌端点|
||--oauth上游客户端id | oauth代理的上游客户端id|
||--oauth上游客户端机密|oauth代理的上游客户端机密|
||--oauth基本url | oauth代理的基本url|
||--oidc配置url |oidc配置url|
||--oidc客户端id|oidc客户端id|
||-oidc客户端机密|oidc客户端机密|
||--oidc基本url |oidc代理的基本url|
||--远程身份验证服务器|远程OAuth的逗号分隔的授权服务器列表|
||--远程基本url |远程OAuth的基本url|
||--允许的客户端重定向URI |逗号分隔的允许客户端重定向URI列表|
||--eunomia type|eunomia授权类型:“无”、“嵌入式”、“远程”(默认值:无)|
||--eunomia策略文件|嵌入式eunomia的策略文件(默认:mcp_policies.json)|
||--eunomia远程url|远程eunomia服务器的url|

### A2A-CLI

#### 端点

- **Web 用户界面**: `http://localhost:9016/` (如果启用)
- **A2A**: `http://localhost:9016/a2a` (发现: `/a2a/.well-known/agent.json`)
- **AG-UI**: `http://localhost:9016/ag-ui` (职位)

短旗 · 长旗 · 描述
-h · --help · 显示帮助信息
--host · 绑定服务器的主机(默认值:0.0.0.0)
--port · 绑定服务器的端口(默认:9016)
--reload · 启用自动重新加载
--provider · LLM提供者:“openai”、“anthropic”、“google”、“huggingface”
--型号id · LLM型号id(默认:nvidia/nemotron-3-super)
--基本url · LLM基本url(适用于OpenAI兼容的提供者)
--api-key · LLM api密钥
--mcp url · mcp服务器url(默认值:http://localhost:8016/mcp)
--web · 启用Pydantic AI web UI · False(环境:Enable_web_UI)

### 用作MCP服务器

MCP服务器可以在两种模式下运行: `stdio` (用于本地测试)或 `http` (用于网络访问)。要启动服务器,请使用以下命令:

#### 在stdio模式下运行(默认):```bash
nextcloud-agent --transport "stdio"

在HTTP模式下运行:```bash

nextcloud-agent --transport "http" --host "0.0.0.0" --port "8016"


AI提示:```text
List all files in my 'Documents' folder.

AI回应:```text
Contents of 'Documents':
[FILE] Project_Proposal.docx (Size: 15403, Modified: Sun, 01 Feb 2026 10:00:00 GMT)
[FILE] Notes.txt (Size: 450, Modified: Sun, 01 Feb 2026 09:30:00 GMT)
[DIR] Financials (Size: -, Modified: Fri, 30 Jan 2026 14:20:00 GMT)


### AI 代理

`nextcloud-agent` 设计用于Agent AI系统。它提供了一组工具,允许代理管理Nextcloud资源。

## 代理人对代理人(A2A)

此软件包还包括一个A2A代理服务器,可用于与Nextcloud MCP服务器交互。

### 命令行界面

|参数|描述|默认值|
|-------------------|----------------------------------------------------------------|--------------------------------|
| `--host` |将服务器绑定到的主机| `0.0.0.0` |
| `--port` |将服务器绑定到的端口| `9016` |
| `--reload` |启用自动重新加载| `False` |
| `--provider` |法学硕士提供者(openai、anthropic、谷歌、hugginface)| `openai` |
| `--model-id` |LLM型号ID| `nvidia/nemotron-3-super` |
| `--base-url` |LLM基本URL(适用于OpenAI兼容提供商)| `http://ollama.arpa/v1` |
| `--api-key` |LLM API密钥| `ollama` |
| `--mcp-url` |MCP服务器URL| `http://nextcloud-mcp:8016/mcp` |
| `--allowed-tools` |允许的MCP工具列表| `list_files`, `...` |

### 示例

#### 运行A2A服务器```bash
nextcloud-agent --provider openai --model-id gpt-4 --api-key sk-... --mcp-url http://localhost:8016/mcp

使用Docker运行```bash

docker run -e CMD=nextcloud-agent -p 9016:9016 nextcloud-agent


## 码头工人

### 构建```bash
docker build -t nextcloud-agent .

运行MCP服务器```bash

docker run -p 8016:8016 nextcloud-agent


### 运行A2A服务器```bash
docker run -e CMD=nextcloud-agent -p 9016:9016 nextcloud-agent

将MCP服务器部署为服务

Nextcloud MCP服务器可以使用Docker部署,具有可配置的身份验证、中间件和Eunomia授权。

使用Docker运行```bash

docker pull knucklessg1/nextcloud-agent:latest

docker run -d \
--name nextcloud-agent \
-p 8016:8016 \
-e HOST=0.0.0.0 \
-e PORT=8016 \
-e TRANSPORT=http \
-e AUTH_TYPE=none \
-e EUNOMIA_TYPE=none \
-e NEXTCLOUD_BASE_URL=https://cloud.example.com \
-e NEXTCLOUD_USERNAME=user \
-e NEXTCLOUD_PASSWORD=pass \
knucklessg1/nextcloud-agent:latest


对于高级身份验证(例如JWT、OAuth代理、OIDC代理、远程OAuth)或Eunomia,添加相关的环境变量:```bash
docker run -d \
--name nextcloud-agent \
-p 8016:8016 \
-e HOST=0.0.0.0 \
-e PORT=8016 \
-e TRANSPORT=http \
-e AUTH_TYPE=oidc-proxy \
-e OIDC_CONFIG_URL=https://provider.com/.well-known/openid-configuration \
-e OIDC_CLIENT_ID=your-client-id \
-e OIDC_CLIENT_SECRET=your-client-secret \
-e OIDC_BASE_URL=https://your-server.com \
-e ALLOWED_CLIENT_REDIRECT_URIS=http://localhost:*,https://*.example.com/* \
-e EUNOMIA_TYPE=embedded \
-e EUNOMIA_POLICY_FILE=/app/mcp_policies.json \
-e NEXTCLOUD_BASE_URL=https://cloud.example.com \
-e NEXTCLOUD_USERNAME=user \
-e NEXTCLOUD_PASSWORD=pass \
knucklessg1/nextcloud-agent:latest

使用Docker Compose

创建一个 docker-compose.yml 文件:```yaml
services:
nextcloud-mcp:
image: knucklessg1/nextcloud-agent:latest
environment:
- HOST=0.0.0.0
- PORT=8016
- TRANSPORT=http
- AUTH_TYPE=none
- EUNOMIA_TYPE=none
- NEXTCLOUD_BASE_URL=https://cloud.example.com
- NEXTCLOUD_USERNAME=user
- NEXTCLOUD_PASSWORD=pass
ports:
- 8016:8016


对于具有身份验证和Eunomia的高级设置:```yaml
services:
nextcloud-mcp:
image: knucklessg1/nextcloud-agent:latest
environment:
- HOST=0.0.0.0
- PORT=8016
- TRANSPORT=http
- AUTH_TYPE=oidc-proxy
- OIDC_CONFIG_URL=https://provider.com/.well-known/openid-configuration
- OIDC_CLIENT_ID=your-client-id
- OIDC_CLIENT_SECRET=your-client-secret
- OIDC_BASE_URL=https://your-server.com
- ALLOWED_CLIENT_REDIRECT_URIS=http://localhost:*,https://*.example.com/*
- EUNOMIA_TYPE=embedded
- EUNOMIA_POLICY_FILE=/app/mcp_policies.json
- NEXTCLOUD_BASE_URL=https://cloud.example.com
- NEXTCLOUD_USERNAME=user
- NEXTCLOUD_PASSWORD=pass
ports:
- 8016:8016
volumes:
- ./mcp_policies.json:/app/mcp_policies.json

运行服务:```bash
docker-compose up -d


#### 配置 `mcp.json` AI集成```json
{
"mcpServers": {
"nextcloud": {
"command": "uv",
"args": [
"run",
"--with",
"nextcloud-agent"
],
"env": {
"NEXTCLOUD_BASE_URL": "https://cloud.example.com",
"NEXTCLOUD_USERNAME": "user",
"NEXTCLOUD_PASSWORD": "pass"
},
"timeout": 300000
}
}
}

安装Python包```bash

python -m pip install nextcloud-agent
``````bash
uv pip install nextcloud-agent


## 存储库所有者

## MCP配置示例

### 1.标准IO(stdio)部署```json
{
"mcpServers": {
"nextcloud-agent": {
"command": "uv",
"args": [
"run",
"nextcloud-mcp"
],
"env": {
"AGENT_DESCRIPTION": "",
"AGENT_SYSTEM_PROMPT": "",
"CALENDARTOOL": "True",
"CONTACTSTOOL": "True",
"DEFAULT_AGENT_NAME": "",
"FILESTOOL": "True",
"MISCTOOL": "True",
"NEXTCLOUD_PASSWORD": "",
"NEXTCLOUD_SSL_VERIFY": "",
"NEXTCLOUD_URL": "",
"NEXTCLOUD_USERNAME": "",
"SHARINGTOOL": "True",
"USERTOOL": "True"
}
}
}
}

2.流式HTTP(SSE)部署```json

{
"mcpServers": {
"nextcloud-agent": {
"command": "uv",
"args": [
"run",
"nextcloud-mcp",
"--transport",
"http",
"--host",
"0.0.0.0",
"--port",
"8000"
],
"env": {
"AGENT_DESCRIPTION": "",
"AGENT_SYSTEM_PROMPT": "",
"CALENDARTOOL": "True",
"CONTACTSTOOL": "True",
"DEFAULT_AGENT_NAME": "",
"FILESTOOL": "True",
"MISCTOOL": "True",
"NEXTCLOUD_PASSWORD": "",
"NEXTCLOUD_SSL_VERIFY": "",
"NEXTCLOUD_URL": "",
"NEXTCLOUD_USERNAME": "",
"SHARINGTOOL": "True",
"USERTOOL": "True"
}
}
}
}
```

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Nextcloud Agent 怎么安装?

在客户端按下面的安装命令接入:docker run -e CMD=nextcloud-agent -p 9016:9016 nextcloud-agent。装完在客户端配置里引用同一个包或端点。

Nextcloud Agent 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Nextcloud Agent 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Nextcloud Agent 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

Nextcloud Agent 能提供哪些能力?

资料显示约 18 个工具;能力标签包括 联系人管理、Python、日程管理、自托管。具体工具清单以官方文档为准。

Nextcloud Agent 需要什么运行环境?

运行时为 Docker;属于本地进程,需要在本机装好运行环境。

Nextcloud Agent 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。