内容
# Proton 日历 MCP 应用
一款深色工业主题的 MCP 应用，直接在 Claude Desktop 中显示您的 Proton 日历事件。
## 功能
- 深色工业 UI 设计
- 月历视图，带有事件指示器
- 即将到来的事件列表
- 点击任意一天，查看其事件
- 从 Proton 日历 ICS 源读取事件
## 要求
- **Node.js** v20+（推荐 v22）
- **Bun**（用于构建）
- **Claude Desktop** 或兼容的 MCP 主机
- 具有共享日历链接的 **Proton 日历** 账户
## 安装
```bash
# 克隆仓库
git clone https://github.com/Rixmerz/proton-calendar-app-mcp.git
cd proton-calendar-app-mcp
# 安装依赖项
npm install
# 构建
npm run build
```
## 获取您的 Proton 日历 URL
1. 访问 [Proton 日历](https://calendar.proton.me)
2. 点击 **设置** （齿轮图标）
3. 进入 **日历** → 选择您的日历
4. 滚动到 **通过链接共享**
5. 创建新链接（或复制现有链接）
6. 复制 **ICS URL** （类似于 `https://calendar.proton.me/api/calendar/v1/url/.../calendar.ics?...`）
## 配置
将以下内容添加到您的 `claude_desktop_config.json`：
**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
```json
{
"mcpServers": {
"proton-calendar": {
"command": "/path/to/node",
"args": [
"/path/to/proton-calendar-app-mcp/dist/index.js",
"--stdio"
],
"env": {
"CALENDAR_URL": "https://calendar.proton.me/api/calendar/v1/url/YOUR_CALENDAR_ID/calendar.ics?CacheKey=...&PassphraseKey=..."
}
}
}
}
```
### 查找您的 Node 路径
```bash
# macOS/Linux
which node
# 或如果使用 nvm
nvm which 22
# Windows
where node
```
## 使用
配置完成后，重启 Claude Desktop 并说：
> "打开我的日历"
或
> "显示我的即将到来的事件"
Claude 将显示日历 UI 以及您的 Proton 日历事件。
## 安全注意事项
您的 `CALENDAR_URL` 包含访问令牌。请保持您的 `claude_desktop_config.json` 私密，切勿将其提交到版本控制中。
## 许可证
MIT
