loading…
Search for a command to run...
loading…
An MCP server that bridges local AI agents to Google Colab notebooks, enabling execution of Python code and interaction with notebook states directly from the a
An MCP server that bridges local AI agents to Google Colab notebooks, enabling execution of Python code and interaction with notebook states directly from the agent.
An MCP (Model Context Protocol) server that seamlessly bridges your local AI agent to a Google Colab session running in your browser.
This MCP server requires a client that supports notifications/tools/list_changed and must be running locally on your device.
Popular clients that meet these criteria include:
Install uv (an extremely fast Python package installer and resolver):
pip install uv
Configure your MCP Client (e.g., in your mcp.json or equivalent configuration file):
{
"mcpServers": {
"colab-mcp": {
"command": "uvx",
"args": ["git+https://github.com/googlecolab/colab-mcp"],
"timeout": 30000
}
}
}
Note for Googlers (or those with non-standard package indexes): You may need to add
--index https://pypi.org/simpleto theargsarray.
We use GitHub Discussions as our primary venue for issue discussion and feature requests.
As discussions mature into clear action items, the maintainers will convert them into tracked issues. This workflow helps us ensure that the issue tracker remains deduplicated, well-understood, and highly actionable.
⚠️ Please do NOT open issues directly.
While we appreciate community interest, we currently do not have the bandwidth to review external contributions. We want to avoid user Pull Requests languishing without review, so we are not accepting external contributions at this time.
If you have a great idea or encounter a pain point, we would love to hear about it on our Discussions page!
uv is required (pip install uv)
Configure git hooks to run repository presubmits:
git config core.hooksPath .githooks
To test your local checkout with the Gemini CLI, use this configuration:
{
"mcpServers": {
"colab-mcp": {
"command": "uv",
"args": ["run", "colab-mcp"],
"cwd": "/path/to/github/colab-mcp",
"timeout": 30000
}
}
}
Добавь это в claude_desktop_config.json и перезапусти Claude Desktop.
{
"mcpServers": {
"colab-mcp": {
"command": "npx",
"args": []
}
}
}