mcp-nextcloud-日历

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

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 存储库上报告任何问题。

执照

国际学习中心

mcp-nextcloud-calendar

MCP Nextcloud 日历

特征

用法

与 npx 一起使用

安装

MCP 客户端配置

指定版本

配置

环境变量

开发设置

获取 Nextcloud 应用令牌

发展

API 端点

MCP 工具

日历管理

活动管理

已知问题和限制

执照

Related MCP Servers

Google Calendar MCP

Python notebook mcp

mcp-server-cloudbrowser

calendar-mcp

New MCP Servers

MCP directory API