MCP Nextcloud 日历

用于 Nextcloud 日历集成的模型上下文协议 (MCP) 服务器。

特征

从 Nextcloud 获取日历
适合注意力缺陷多动障碍 (ADHD) 的组织功能
MCP 协议支持（可流式传输的 HTTP 和旧式 HTTP+SSE）

Related MCP server: mcp-server-cloudbrowser

用法

与 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

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 工具已注册并可供客户使用：

日历管理

工具	描述	参数
`listCalendars`	检索所有可访问的日历	没有任何
`createCalendar`	创建新日历	`displayName` （必需）、 `color` （可选）、 `category` （可选）、 `focusPriority` （可选）
`updateCalendar`	更新现有日历	`id` （必需）、 `displayName` （可选）、 `color` （可选）、 `category` （可选）、 `focusPriority` （可选）
`deleteCalendar`	删除日历	`id` （必填）

⚠️ 权限警告： updateCalendar和deleteCalendar工具可能需要 Nextcloud 实例中的特殊权限。日历操作受 Nextcloud 权限系统的约束。

活动管理

工具	描述	参数
`listEvents`	检索日历的事件	`calendarId` （必需）、 `start` （可选）、 `end` （可选）
`getEvent`	获取特定事件	`calendarId` （必填）、 `eventId` （必填）
`createEvent`	创建新事件	`calendarId` （必填）、 `summary` （必填）、 `start` （必填）、 `end` （必填）、 `description` （可选）、 `location` （可选）
`updateEvent`	更新现有事件	`calendarId` （必需）、 `eventId` （必需），[以及要更新的任何事件属性]
`deleteEvent`	删除事件	`calendarId` （必填）、 `eventId` （必填）

已知问题和限制

注意：此软件包目前处于早期开发阶段（0.1.x）。API 和工具在未来版本中可能会有所变更，恕不另行通知。

更新和删除日历操作可能需要 Nextcloud 实例中的特定权限
特定 Nextcloud 错误代码的错误处理仍在改进中
包含许多事件的大型日历可能会遇到性能问题

请在 GitHub 存储库上报告任何问题。

执照

国际学习中心

This server cannot be installed

A

license - permissive license

-

quality - not tested

C

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Issues opened vs closed

Resources

Need Help?

Related Servers

mcp-nextcloud-calendar