MIT License
MCP Nextcloud 日历
用于 Nextcloud 日历集成的模型上下文协议 (MCP) 服务器。
特征
从 Nextcloud 获取日历
适合注意力缺陷多动障碍 (ADHD) 的组织功能
MCP 协议支持（可流式传输的 HTTP 和旧式 HTTP+SSE）
用法
与 npx 一起使用
使用此包的最简单方法是使用 npx：
npx mcp-nextcloud-calendar
安装
对于开发或本地安装：
# Install globally
npm install -g mcp-nextcloud-calendar
# Or install locally
npm install mcp-nextcloud-calendar
MCP 客户端配置
要与 MCP 客户端（如 Claude）一起使用，请将此配置添加到您的 MCP 客户端设置中：
{
"mcpServers": {
"nextcloud-calendar": {
"command": "npx",
"args": ["-y", "mcp-nextcloud-calendar"],
"env": {
"NEXTCLOUD_BASE_URL": "https://your-nextcloud-server.com",
"NEXTCLOUD_USERNAME": "your-username",
"NEXTCLOUD_APP_TOKEN": "your-app-token"
}
}
}
}
指定版本
您可以固定到软件包的特定版本：
{
"mcpServers": {
"nextcloud-calendar": {
"command": "npx",
"args": ["-y", "mcp-nextcloud-calendar@0.1.0"],
"env": {
"NEXTCLOUD_BASE_URL": "https://your-nextcloud-server.com",
"NEXTCLOUD_USERNAME": "your-username",
"NEXTCLOUD_APP_TOKEN": "your-app-token"
}
}
}
}
配置
环境变量
服务器使用这些环境变量，并尽可能使用默认值：
多变的 | 描述 | 默认 | 必需的 |
港口 | 服务器端口 | 3001 | 不 |
服务器名称 | MCP 服务器标识符 | NextCloud 日历服务器 | 不 |
NODE_ENV | 环境（开发/生产） | 发展 | 不 |
NEXTCLOUD_BASE_URL | 您的 Nextcloud 服务器 URL | - | 是的 |
NEXTCLOUD_用户名 | 您的 Nextcloud 用户名 | - | 是的 |
NEXTCLOUD_APP_TOKEN | 您的 Nextcloud 应用令牌 | - | 是的 |
保持活动间隔 | 保持活动间隔（毫秒） | 30000 | 不 |
开发设置
对于本地开发：
克隆存储库
安装依赖项：
npm install
在项目根目录中创建一个
.env文件：
cp .env.example .env
使用您的 Nextcloud 凭据编辑
.env文件。
获取 Nextcloud 应用令牌
登录到您的 Nextcloud 实例
前往“设置”→“安全”→“应用密码”
创建一个新的应用密码，名称例如“MCP 日历”
将生成的令牌复制到你的
.env文件
发展
# Build the project
npm run build
# Run in development mode
npm run dev
# Run tests
npm run test
# Run linting
npm run lint
# Format code
npm run format
API 端点
/mcp- 主 MCP 端点（可流式传输的 HTTP 传输）/sse和/messages- 传统 MCP 端点（HTTP+SSE 传输）GET /health- 健康检查端点GET /api/calendars- 列出所有日历
MCP 工具
以下 MCP 工具已注册并可供客户使用：
日历管理
工具 | 描述 | 参数 |
| 检索所有可访问的日历 | 没有任何 |
| 创建新日历 |
（必需）、
（可选）、
（可选）、
（可选） |
| 更新现有日历 |
（必需）、
（可选）、
（可选）、
（可选）、
（可选） |
| 删除日历 |
（必填） |
⚠️ 权限警告：
updateCalendar和deleteCalendar工具可能需要 Nextcloud 实例中的特殊权限。日历操作受 Nextcloud 权限系统的约束。
活动管理
工具 | 描述 | 参数 |
| 检索日历的事件 |
（必需）、
（可选）、
（可选） |
| 获取特定事件 |
（必填）、
（必填） |
| 创建新事件 |
（必填）、
（必填）、
（必填）、
（必填）、
（可选）、
（可选） |
| 更新现有事件 |
（必需）、
（必需），[以及要更新的任何事件属性] |
| 删除事件 |
（必填）、
（必填） |
已知问题和限制
注意：此软件包目前处于早期开发阶段（0.1.x）。API 和工具在未来版本中可能会有所变更，恕不另行通知。
更新和删除日历操作可能需要 Nextcloud 实例中的特定权限
特定 Nextcloud 错误代码的错误处理仍在改进中
包含许多事件的大型日历可能会遇到性能问题
请在 GitHub 存储库上报告任何问题。
执照
国际学习中心
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
mcp-nextcloud-日历
Related MCP Servers
- MIT License