AI导哈

文档管理协议服务器

Proton Docs MCP是一个模型上下文协议服务器，使AI助手能够通过浏览器自动化与Proton Docs文档进行交互，支持创建、读取、编辑、格式化、共享和导出文档等多种功能。

  • by anyrxo
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 anyrxo/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提供以下工具：

工具 说明 参数
list_documents 列出所有可选择搜索的文档 searchQuery?, limit
create_document 创建新文档 title, content?
read_document 读取文档内容 documentUrl
edit_document 编辑文档内容 documentUrl, content, append?
delete_document 删除文档 documentUrl, permanent?
search_documents 按内容搜索文档 query
share_document 与用户共享文档 documentUrl, email, permission
format_text 应用文本格式 documentUrl, format, text?
insert_list 在文档中创建列表 documentUrl, type, items
insert_link 添加文档链接 documentUrl, text, url
change_font 修改字体属性 documentUrl, property, value
align_text 设置文本对齐方式 documentUrl, alignment
export_document 导出为各种格式 documentUrl, format
get_version_history 访问文档版本 documentUrl
copy_document 复制文档 documentUrl, newTitle?

🧪 测试

测试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包
  • 🔧 专业的：生产准备就绪，错误处理得当
  • 📚 有据可查：包括完整的指南和示例

🔗 相关项目

📊 统计

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

相关 MCP