Proton Docs MCP

Proton Docs MCP

一个模型上下文协议（MCP）服务器，使Claude Desktop、Cursor和其他MCP兼容客户端等AI助手能够通过浏览器自动化与您的Proton Docs文档进行交互。

✨ 特性

• 📄 创建文档 具有自定义标题和内容
• 📖 读取文档内容 直接来自Proton Docs
• ✏️ 编辑文档 具有附加或替换功能
• 📝 文字格式 （粗体、斜体、下划线、删除线）
• 📋 列表管理 （有序和无序列表）
• 🔗 链接插入 和管理
• 🎨 字体定制 （家庭、大小、颜色）
• 📐 文本对齐方式 （左、中、右、对齐）
• 🗑️ 删除文档 （丢弃或永久）
• 📤 出口单据 （DOCX、PDF、TXT、Markdown）
• 🔍 搜索文档 按内容
• 👥 共享文档 与其他用户
• 📊 文档列表 具有可选的搜索筛选功能
• 📚 版本历史 访问
• 🔐 安全的浏览器自动化 通过Puppeter

📋 先决条件

• Node.js 16或更高版本
• 可访问Proton Docs的有效Proton帐户
• Claude Desktop、Cursor或任何兼容MCP的客户端

🚀 快速开始

1.从npm安装（推荐）

npm install -g proton-docs-mcp

2.或从源代码安装

git clone https://github.com/anyrxo/proton-docs-mcp.git
cd proton-docs-mcp
npm install
npm run build

⚙️ 配置

克劳德桌面

添加到您的Claude Desktop配置中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "proton-docs": {
      "command": "node",
      "args": ["path/to/proton-docs-mcp/dist/index.js"],
      "env": {
        "PROTON_EMAIL": "your-email@proton.me",
        "PROTON_PASSWORD": "your-password"
      }
    }
  }
}

光标

添加到光标设置中：

{
  "mcp.servers": {
    "proton-docs": {
      "command": "node",
      "args": ["path/to/proton-docs-mcp/dist/index.js"],
      "env": {
        "PROTON_EMAIL": "your-email@proton.me",
        "PROTON_PASSWORD": "your-password"
      }
    }
  }
}

环境变量

将Proton凭据设置为环境变量：

export PROTON_EMAIL="your-email@proton.me"
export PROTON_PASSWORD="your-password"

或者创建一个 .env 项目根目录中的文件：

PROTON_EMAIL=your-email@proton.me
PROTON_PASSWORD=your-password

🎯 使用示例

配置后，您可以询问您的AI助手：

• “使用今天的议程创建一个名为“会议笔记”的新文档”
• “列出我的所有Proton Docs文档”
• “阅读我的“项目计划”文档的内容”
• “将文档中的文本加粗并添加项目符号列表”
• “将我的文档导出为PDF”
• “与共享我的文档colleague@example.com具有编辑权限”
• “搜索包含‘季度报告’的文档”
• “删除旧的草稿文档”

🛠️ 可用工具

MCP提供以下工具：

🧪 测试

测试MCP是否工作：

# Build the project
npm run build

# Test connection
npm run dev

🔧 故障排除

身份验证问题

1. 验证您的Proton凭据是否正确
2. 检查是否启用了2FA（可能需要特定于应用程序的密码）
3. 确保环境变量设置正确

浏览器自动化问题

• 确保您有足够的系统资源
• 检查您所在地区是否可以访问Proton Docs
• 验证与Proton服务的网络连接

工具未显示在Claude/Cursor中

1. 配置后重新启动AI客户端
2. 检查日志中是否有任何错误消息
3. 验证MCP服务器的路径是否正确
4. 确保安装了所有依赖项

📝 发展

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Run tests
npm test

🔒 安全考虑

• 凭证：使用环境变量安全地存储凭据
• 浏览器隔离：每个会话都在单独的浏览器实例中运行
• 无数据存储：没有缓存或本地存储文档内容
• 仅限HTTPS：与Proton服务的所有通信都使用HTTPS
• 会话管理：自动清理浏览器会话

🤝 贡献

欢迎投稿！拜托：

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 如果适用，添加测试
5. 提交拉取请求

📄 许可证

MIT许可证-请参阅 许可证 文件

🐛 已知问题

• 处理大型文档可能需要时间
• 复杂的格式化操作可能需要多个步骤
• 速率限制可能适用于大规模操作
• 浏览器自动化需要图形环境

📮 支持

• 问题：
• 讨论：

🏆 为什么选择Proton Docs MCP？

• 🔒 隐私第一：专为Proton注重隐私的生态系统而打造
• 🤖 人工智能原生：专为AI助手集成而设计
• ⚡ 全面的：14多种工具，满足所有文档管理需求
• 🛡️ 安全：无数据存储，浏览器隔离，仅HTTPS
• 📦 简易安装：具有全局CLI支持的npm包
• 🔧 专业的：生产准备就绪，错误处理得当
• 📚 有据可查：包括完整的指南和示例

🔗 相关项目

• 质子驱动mcp -Proton Drive的MCP服务器
• 模型上下文协议 -MCP官方规范

📊 统计

______________________________________________________________________

由以下材料制成❤️ Proton生态系统和人工智能自动化社区