一个MCP服务器，用于将本地代理桥接到浏览器中的Colab会话。

支持客户

该MCP服务器需要客户端支持notifications/tools/list_changed，并且客户端必须在你的设备上本地运行。

符合这些条件的热门客户包括：

• Gemini CLI
• 克劳德密码
• 风帆冲浪

布置

• 安装 uv （pip install uv）
• 配置使用（例如mcp.json风格服务）：

（如果你有非标准默认包索引（Googlers），你可能还需要添加 --index https://pypi.org/simple）

议题与讨论

我们正在使用 GitHub 讨论作为 讨论问题和功能请求的地方。随着讨论逐渐发展为行动项目，我们 将这些项目作为问题添加。这有助于我们确保问题追踪器中的问题是 充分理解、去重且可操作。基于以上原因，请勿打开 直接问题。

贡献

很遗憾，我们没有足够的精力支持外部贡献的审核，而且我们 不想让用户公关被拖垮，所以我们目前不接受任何外部贡献。

如果您有好主意或痛点，我们非常乐意在我们的网站上听到您的分享

Colab-mcp

An MCP server for bridging your local agent to a Colab session in the browser.

Supported Clients

This MCP server requires client support for notifications/tools/list_changed and for the client to be running locally on your device.

Popular clients that fit these criteria include:

• Gemini CLI
• Claude Code
• Windsurf

Setup

• Install uv (pip install uv)
• Configure for usage (eg for mcp.json style services):

...
  "mcpServers": {
    "colab-mcp": {
      "command": "uvx",
      "args": ["git+https://github.com/googlecolab/colab-mcp"],
      "timeout": 30000
    }
  }
...

(If you have a non-standard default package index (Googlers), you may also need to add --index https://pypi.org/simple)

Issues & Discussions

We are using GitHub discussions as the place for issue discussion and feature requests. As discussions mature into action items, we will add those items as issues. This helps us ensure that issues in the issue tracker are well-understood, deduplicated, and actionable. For these reasons, please do NOT open issues directly.

Contributing

We unfortunately don’t have the bandwidth to support review of external contributions, and we don’t want user PRs to languish, so we aren’t accepting any external contributions right now.

If you have a great idea or pain point, we would love to hear about it on our discussions page - the preferred place for issue discussion and feature requests.

Internal - For Colab Developers

Prerequisites

• uv is required (pip install uv)
• Configure git hooks to run repo presubmits

git config core.hooksPath .githooks

Gemini CLI setup

...
  "mcpServers": {
    "colab-mcp": {
      "command": "uv",
      "args": ["run", "colab-mcp"],
      "cwd": "/path/to/github/colab-mcp",
      "timeout": 30000
    }
  }
...