# 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:

```bash
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:**
   ```bash
   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):

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

## Manual Installation

If you want to run it locally:

1. **Install Dependencies:**
   ```bash
   bun install
   ```

2. **Run Server:**
   ```bash
   bun run index.ts
   ```

## Requirements
- [Bun](https://bun.sh) runtime installed.
- A running Google Colab instance with the bridge script active.