Colab MCP Client (TypeScript)

A high-performance Model Context Protocol (MCP) server for controlling Google Colab instances via a reverse proxy (ngrok, serveo, etc.).

Features

• connect_to_colab: Link to your running Colab instance.

• run_colab_shell: Execute shell commands.

• run_colab_python: Run persistent Python code.

• get_colab_system_info: Monitor CPU/GPU/RAM.

Quick Start (No Install)

You can run this MCP server directly using Bun:

bun https://github.com/DevAdalat/colab-mcp/releases/download/v1.0.0/colab-bridge.js

Adding to MCP Agents (Claude Desktop, etc.)

For a stable setup, it is recommended to download the file locally:

1. Download the binary/script:

   curl -LO https://github.com/DevAdalat/colab-mcp/releases/download/v1.0.0/colab-bridge.js

2. Add to Claude Desktop: Update your claude_desktop_config.json (usually at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "colab-bridge": {
      "command": "bun",
      "args": [
        "/absolute/path/to/colab-bridge.js"
      ]
    }
  }
}

Manual Installation

If you want to run it locally:

1. Install Dependencies:

   bun install

2. Run Server:

   bun run index.ts

Requirements

• Bun runtime installed.

• A running Google Colab instance with the bridge script active.