使用说明
MCP创建者
自托管MCP（模型上下文协议）连接器基础架构 -在任何设备（iPhone、笔记本电脑、台式机）上从Claude访问Gmail、GitHub、Todoist、Slack、Notion、家庭助理和iCloud。
🚀 快速开始
选择您的路径：
| 我想… | 导游 | 时间 |
|---|---|---|
| 使用所有8个连接器在Proxmox上部署所有内容 | 部署指南.md | 1-2小时 |
| 快速最小设置（2-3个连接器） | 快速启动最小值.md | 30-45分钟 |
| 获取所有服务的API凭据 | CREDENTIALS-GUIDE.md | 参考资料 |
📦 包含什么
8个生产就绪的MCP连接器+跨服务集成商
| 连接器 | 服务 | 状态 | 文档 |
|---|---|---|---|
| GitHub | 回复、问题、PR、行动 | ✅ 准备好了 | mcp/github/README.md |
| 谷歌 | Gmail、驱动器、日历、照片 | ✅ 准备好了 | mcp/google/README.md |
| 简洁日程 | 任务、项目、标签 | ✅ 准备好了 | mcp/todoist/README.md |
| 家庭助手 | 智能家居控制 | ✅ 准备好了 | mcp/家庭助理/README.md |
| 概念 | 数据库、页面、块 | ✅ 准备好了 | mcp/concept/README.md |
| Slack | 消息、频道、文件 | ✅ 准备好了 | mcp/lack/README.md |
| 苹果云 | 邮件、日历、通讯录、驱动器 | ✅ 准备好了 | mcp/icloud/README.md |
| 展望 | 电子邮件、日历（只读）+优先级AI | ✅ 准备好了 | mcp/outlook/README.md |
| 整合者 | 跨军种情报（Meta MCP） | ✅ 准备好了 | mcp/integrator/README.md |
主要特点
✅ 远程访问 -从iPhone、笔记本电脑、任何带Claude的设备上使用 ✅ 安全 -无需端口转发（Cloudflare隧道） ✅ 自托管 -完全控制，在Proxmox/VPS/家庭服务器上运行 ✅ 零信任 -可选Cloudflare身份验证层 ✅ 基于Docker -易于部署和更新 ✅ 生产准备就绪 -配备监控和记录功能
📖 文档
入门指南
- 设置.md -所有MCP服务的完整设置指南
- CLOUDFLARE-TUNNEL-SETUP.md -任何设备（iPhone、笔记本电脑等）的远程访问设置
- TUNNEL-SETUP-COMMANDS.md -SSH/终端设置的快速命令参考
- CREDENTIALS-GUIDE.md -如何获取所有服务的凭据
- CLAUDE-DESKTOP-SETUP.md -Claude桌面配置指南
建筑与研究
- 架构/自托管架构.md -系统设计和架构
- 架构/cloudflare-tunnel-setup.md -Cloudflare隧道配置
- 研究/mcp协议概述.md -MCP协议规范
- 研究/安全授权.md -OAuth 2.1安全实现
部署资源
- 部署/部署完成.md -生产部署参考
- 部署/PROXMOX-SETUP.md -Proxmox特定配置
🎯 架构概述
┌─────────────────┐
│ Your Devices │ ← iPhone, Laptop, Desktop
│ (Claude Apps) │
└────────┬────────┘
│ HTTPS
▼
┌─────────────────┐
│ Cloudflare │ ← Zero Trust + Tunnel
│ Edge Network │
└────────┬────────┘
│ Encrypted Tunnel
▼
┌─────────────────┐
│ Proxmox Server │
│ (LXC/Docker) │ ← Your self-hosted infrastructure
│ │
│ 7 MCP Servers │ ← GitHub, Google, Todoist, etc.
└─────────────────┘
🔧 你需要的
硬件：
- Proxmox服务器、VPS或任何带有Docker的Linux机器
- 最低4GB RAM（最低设置为2GB）
- 20GB磁盘空间
服务：
- 域名（指向Cloudflare）
- Cloudflare帐户（免费版有效）
- 要使用的服务的API凭据
总成本： 约10-15美元/年（如果自托管，只需域名）
📱 用例
部署后，请Claude：
Gmail：
- “检查我的未读电子邮件”
- “搜索来自的电子邮件john@example.com关于该项目”
- “发送电子邮件至…”
github：
- “列出我的存储库”
- “在我的仓库中创建问题”
- “显示打开的PR”
待办事项：
- “今天有什么任务要交？”
- “创建新任务：部署MCP服务器”
- “完成“设置凭据”任务”
家庭助理：
- “打开客厅的灯”
- “卧室里的温度是多少？”
- “将恒温器设置为72度”
概念：
- “列出我的数据库”
- “在我的Notes数据库中创建新页面”
- “查询我的任务数据库”
松弛：
- “以#general显示最近的消息”
- “向#team发送消息”
- 在Slack中搜索“部署”
Icloud：
- “查看我今天的iCloud日历”
- “列出我的iCloud提醒”
- “显示我的iCloud联系人”
见解：
- “检查我的Outlook未读电子邮件”
- “建立我今天的优先行动列表”
- “给我每日简报”
- “我的Outlook日历上有什么？”
集成商（跨服务）：
- “显示所有未读邮件”（Outlook+Gmail+Slack）
- “给我一个全面的简报”（所有服务）
- “到处搜索‘阿尔法项目’”
- “检查我所有MCP服务的健康状况”
🛡️ 安全
所有凭据为：
- ✅ Gitigned（从未提交）
- ✅ 传输中加密（Cloudflare隧道）
- ✅ 受限权限（chmod 600）
- ✅ 可选的零信任身份验证
🤝 贡献
欢迎投稿！要添加新的MCP连接器：
- 创建
mcp/yourservice/目录 - 使用MCP SDK实现
- 增添
docker-compose.minimal.yml - 文档在
mcp/yourservice/README.md - 提交PR
📄 许可证
MIT许可证-请参阅 许可证 详情
🙏 致谢
内置：
- 模型上下文协议（MCP） 通过Anthropic
- Cloudflare隧道
- Docker&Docker编写
- Python 3.11+
需要帮助？
- 📖 从开始 部署指南.md
- 🔑 凭证问题？看 CREDENTIALS-GUIDE.md
- 🐛 发现bug了吗？ 打开一个问题
最后更新时间： 2025-11-09
