MCP Colab

用于Jupyter MCP服务器的Google Colab Bridge

连接您的本地 Jupyter MCP服务器 Google Colab的GPU/TPU硬件支持实时协作。

🎯 这有什么作用

使AI代理（Claude、Codex等）能够与运行在其上的Jupyter笔记本协同工作 谷歌Colab的硬件 当你看到变化时 生活 在您的浏览器中。

Your Machine:                Google Colab:
┌─────────────┐             ┌──────────────┐
│Claude/Codex │             │Jupyter Server│
│     ↓       │             │      ↓       │
│ MCP Server  │             │Python Kernel │
│     ↓       │             │  (GPU/TPU)   │
│ JupyterLab ─┼→Cloudflare─→│              │
└─────────────┘  Tunnel     └──────────────┘

✨ 特性

• 🚀 GPU/TPU访问：在Colab强大的硬件上运行实验
• 👀 实时更新：通过Jupyter RTC即时查看AI变化
• 🔌 MCP无变化：您现有的MCP配置工作不变
• 🌐 持久域：通过您的子域访问（例如。， colab.yourdomain.com)
• 💾 驱动持久性：跨会话保存隧道凭据
• 🔒 安全：通过Cloudflare隧道的HTTPS

📋 先决条件

• Google Colab帐户（专业版推荐）
• 具有域的Cloudflare帐户
• 本地机器具有：

- Jupyter MCP服务器 安装 - JupyterLab已安装 - Claude Desktop或其他MCP客户端

🚀 快速开始

1.上传安装笔记本

上传 colab/Colab_MCP_Setup.ipynb 谷歌Colab并运行所有单元格。

2.配置Cloudflare（一次性）

在Colab终端：

cloudflared tunnel login
cloudflared tunnel create colab-tunnel

在Cloudflare仪表板中更新DNS：

• c名称： colab.yourdomain.com → .cfargotunnel.com

3.启动服务

在Colab：

./start_jupyter_server.sh
./start_cloudflare_tunnel.sh

4.连接JupyterLab

在您的本地计算机上：

jupyter lab --gateway-url=https://colab.yourdomain.com

5.使用MCP服务器

您现有的配置按原样工作！MCP服务器连接到本地JupyterLab，后者连接到Colab的内核。

📚 文档

• 快速入门指南 -15分钟设置
• 完成设置 -详细说明
• JupyterLab连接 -连接选项

📁 存储库结构

.
├── colab/
│   ├── Colab_MCP_Setup.ipynb          # Interactive setup notebook
│   ├── setup_jupyter_server.sh        # Install dependencies
│   ├── start_jupyter_server.sh        # Start Jupyter Server
│   ├── start_cloudflare_tunnel.sh     # Start tunnel
│   └── cloudflare-tunnel.yml.template # Tunnel configuration
├── docs/
│   ├── COLAB_SETUP.md                 # Complete setup guide
│   └── JUPYTERLAB_CONNECTION.md       # Connection instructions
├── COLAB_QUICKSTART.md                # Quick start guide
└── README.md                          # This file

🔄 工作流程

首次设置（约15分钟）

1. 配置Cloudflare隧道
2. 上传并运行安装笔记本
3. 在本地连接JupyterLab
4. 开始使用MCP服务器

后续会议（约2分钟）

1. 从Google云端硬盘恢复凭据
2. 在Colab开始服务
3. 连接JupyterLab
4. 继续工作

🛠️ 故障排除

请参阅 完整安装指南 了解详细的故障排除步骤。

常见问题：

• 隧道无法进入：检查DNS传播，重新启动隧道
• Jupyter没有响应：重新启动Jupyter服务器
• Colab已断开连接：使用Colab Pro，保持活力脚本

🔒 安全

当前设置：

• ✅ 通过Cloudflare进行HTTPS
• ⚠️ 无Jupyter身份验证（隧道处理）

生产：

• 添加Cloudflare访问以进行身份验证
• 使用Cloudflare WAF限制访问
• 定期监控日志

💡 提示

1. 将凭据保存到Google云端硬盘 -避免重新配置每个会话
2. 使用Colab Pro -更好的GPU，更长的会话
3. 将笔记本提交到Git -不要失去工作
4. 监控Colab运行时间 -防止空闲断开连接
5. 文档依赖关系 -保持 requirements.txt 更新

🤝 贡献

欢迎投稿！需要改进的地方：

• 自动重新连接脚本
• 更好的错误处理
• 监控仪表板
• 其他云提供商

📄 许可证

BSD 3条款许可证-请参阅许可证文件

🔗 相关项目

• Jupyter MCP服务器 -此连接到的MCP服务器
• 模型上下文协议 -MCP规范
• Cloudflare隧道 -安全隧道

💬 支持

• 问题:
• 讨论:
• 云耀: 社区论坛
• 朱庇特: 论述

⭐ 明星历史

如果你觉得这很有用，请考虑在存储库中担任主角！

______________________________________________________________________

由以下材料制成❤️ 面向人工智能辅助编码社区