🪐 Colab MCP (Model Context Protocol)

로컬 AI 에이전트를 브라우저에서 실행 중인 Google Colab 세션에 원활하게 연결하는 MCP (Model Context Protocol) 서버입니다.

✨ 주요 기능

• 로컬 AI 어시스턴트를 브라우저 기반 Colab 노트북에 직접 연결

• 에이전트를 통해 Colab에서 Python 코드 실행 지원

• Colab 노트북 상태 읽기 및 상호 작용

Related MCP server: colab-mcp

💻 지원되는 클라이언트

이 MCP 서버는 notifications/tools/list_changed를 지원하는 클라이언트가 필요하며, 사용자의 기기에서 로컬로 실행되어야 합니다.

이 기준을 충족하는 주요 클라이언트는 다음과 같습니다:

• Gemini CLI

• Claude Code

• Windsurf

🚀 설치 및 설정

1. uv 설치 (매우 빠른 Python 패키지 설치 및 해결 도구):

   pip install uv

2. MCP 클라이언트 구성 (mcp.json 또는 이에 상응하는 구성 파일):

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

   Googler(또는 비표준 패키지 인덱스 사용자)를 위한 참고 사항: args 배열에 --index https://pypi.org/simple을 추가해야 할 수도 있습니다.

💬 문제 및 토론

GitHub Discussions를 문제 토론 및 기능 요청을 위한 주요 창구로 사용하고 있습니다.

토론이 명확한 실행 항목으로 발전하면 관리자가 이를 추적 가능한 이슈로 변환합니다. 이 워크플로우는 이슈 트래커가 중복되지 않고, 명확하게 이해되며, 실행 가능한 상태로 유지되도록 돕습니다.

⚠️ 이슈를 직접 생성하지 마십시오.

🤝 기여

커뮤니티의 관심은 감사하지만, 현재 외부 기여를 검토할 여력이 없습니다. 사용자 Pull Request가 검토 없이 방치되는 것을 원치 않으므로 현재 외부 기여는 받지 않고 있습니다.

좋은 아이디어가 있거나 불편한 점이 있다면 Discussions 페이지에서 의견을 공유해 주세요!

🛠️ 내부용 (Colab 개발자용)

사전 요구 사항

• uv가 필요합니다 (pip install uv)

• 저장소 사전 제출(presubmit)을 실행하도록 git 훅을 구성하세요:

  git config core.hooksPath .githooks

로컬 개발 설정 (Gemini CLI)

Gemini CLI로 로컬 체크아웃을 테스트하려면 다음 구성을 사용하세요:

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

MCP_Colab