convez.ai
MCP ServerDados & AnalyticsIntermediário
Seif-Sameh

Kaggle MCP Server

Seif-Sameh/Kaggle-mcp

Integre Kaggle ao Claude — competições, datasets e modelos via MCP

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que integra a API do Kaggle ao Claude Desktop e clientes MCP-compatíveis. Permite gerenciar competições, datasets, kernels e modelos de ML diretamente através do Claude, com suporte completo a busca, download, upload e versionamento.

Instalação

$npx convez-ai Seif-Sameh/Kaggle-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
v0.1.1
Issues abertas
1
Contribuidores
1

Casos de uso

  • Pesquisar e baixar datasets do Kaggle para análise em tempo real
  • Gerenciar submissões em competições Kaggle sem sair do Claude
  • Versionar e publicar kernels e modelos ML diretamente da IA

Veredito

Solução prática para quem trabalha com competições e datasets Kaggle. A integração MCP reduz fricção ao automatizar fluxos de pesquisa e gerenciamento de dados, embora exija configuração adequada de credenciais.

README

A tradução para o português deste README ainda está na fila.

Kaggle MCP Server

PyPI MCP Registry License: MIT

A Model Context Protocol (MCP) server that provides seamless integration with the Kaggle API. Interact with Kaggle competitions, datasets, kernels, and models through MCP-compatible clients like Claude Desktop.

Features

  • Competitions: List, download files, submit, view leaderboards and submissions
  • Datasets: Search, download, create, and manage datasets with version control
  • Kernels: List, push, pull, and manage Kaggle notebooks and scripts
  • Models: Create, update, and manage ML models and instances with full version control

Installation

Prerequisites

  • Python 3.10 or higher
  • A Kaggle account with API credentials

Install from PyPI

The recommended way is to run the server with uvx, which handles the install for you:

uvx mcp-server-kaggle

Or install it explicitly:

pip install mcp-server-kaggle
# or
uv tool install mcp-server-kaggle

Install from Source

For development or local modifications:

git clone https://github.com/Seif-Sameh/Kaggle-mcp.git
cd Kaggle-mcp
uv sync

Setup

1. Get Your Kaggle API Credentials

  1. Go to https://www.kaggle.com/account
  2. Scroll to the "API" section
  3. Click "Create New Token"
  4. This downloads kaggle.json with your credentials

2. Configure Credentials

Option A: Environment Variables (Recommended)

export KAGGLE_USERNAME=your_username
export KAGGLE_API_KEY=your_api_key

Or add to your ~/.zshrc or ~/.bashrc:

echo 'export KAGGLE_USERNAME=your_username' >> ~/.zshrc
echo 'export KAGGLE_API_KEY=your_api_key' >> ~/.zshrc
source ~/.zshrc

Option B: Using .env File

Create a .env file in your project directory:

KAGGLE_USERNAME=your_username
KAGGLE_API_KEY=your_api_key

Usage

With Claude Desktop

The recommended way to use Kaggle MCP is with Claude Desktop.

  1. Locate your Claude Desktop config file:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • Linux: ~/.config/Claude/claude_desktop_config.json
  2. Add the Kaggle MCP server configuration:

{
  "mcpServers": {
    "kaggle": {
      "command": "uvx",
      "args": ["mcp-server-kaggle"],
      "env": {
        "KAGGLE_USERNAME": "YOUR_KAGGLE_USERNAME",
        "KAGGLE_API_KEY": "YOUR_KAGGLE_API_KEY"
      }
    }
  }
}
{
  "mcpServers": {
    "kaggle": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/Kaggle-mcp",
        "run",
        "mcp-server-kaggle"
      ],
      "env": {
        "KAGGLE_USERNAME": "YOUR_KAGGLE_USERNAME",
        "KAGGLE_API_KEY": "YOUR_KAGGLE_API_KEY"
      }
    }
  }
}
  1. Restart Claude Desktop

  2. Start using Kaggle through Claude!

Try asking Claude:

  • "List the latest Kaggle competitions"
  • "Download the Titanic dataset"
  • "Show me my recent competition submissions"
  • "Search for NLP datasets"

Standalone Usage

Run the MCP server directly:

mcp-server-kaggle

Or as a Python module:

python -m kaggle_mcp

Available Tools

Competitions (8 tools)

ToolDescription
competitions_listList and search available competitions
competition_list_filesList all files in a competition
competition_download_fileDownload a specific competition file
competition_download_filesDownload all competition files
competition_submitSubmit predictions to a competition
competition_submissionsView your submission history
competition_leaderboard_viewView the competition leaderboard
competition_leaderboard_downloadDownload leaderboard data

Datasets (10 tools)

ToolDescription
datasets_listSearch and filter datasets
dataset_metadataGet dataset metadata
dataset_list_filesList files in a dataset
dataset_statusCheck dataset processing status
dataset_download_fileDownload a specific dataset file
dataset_download_filesDownload all dataset files
dataset_createCreate a new dataset
dataset_initializeInitialize dataset metadata
dataset_create_versionCreate a new dataset version

Kernels (7 tools)

ToolDescription
kernels_listSearch and filter kernels
kernel_list_filesList files in a kernel
kernel_initializeInitialize kernel metadata
kernel_pushPush a kernel to Kaggle
kernel_pullDownload a kernel
kernel_outputDownload kernel output files
kernel_statusCheck kernel execution status

Models (14 tools)

ToolDescription
models_listSearch and filter models
model_getGet model details and metadata
model_initializeInitialize model metadata
model_createCreate a new model
model_updateUpdate model information
model_deleteDelete a model
model_instance_getGet model instance details
model_instance_initializeInitialize model instance metadata
model_instance_createCreate a new model instance
model_instance_updateUpdate a model instance
model_instance_deleteDelete a model instance
model_instance_version_createCreate a new model version
model_instance_version_downloadDownload a model version
model_instance_version_deleteDelete a model version

Examples

Example 1: Working with Competitions

Ask Claude:

"List active Kaggle competitions about computer vision"

Claude will use the competitions_list tool to search and display relevant competitions.

Example 2: Downloading Datasets

Ask Claude:

"Download the Titanic dataset to my Downloads folder"

Claude will use dataset_download_files to fetch all dataset files.

Example 3: Submitting to Competitions

Ask Claude:

"Submit my predictions.csv to the Titanic competition with the message 'Initial baseline model'"

Claude will use competition_submit to upload your submission.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Ver o original no GitHub

Bom para

Relacionados