Metadata-Version: 2.4
Name: mseep-kaggle-mcp
Version: 0.1.1
Summary: Kaggle API integration through the Model Context Protocol
Home-page: https://github.com/54yyyu/kaggle-mcp
Author: mseep
Author-email: mseep <support@skydeck.ai>
Maintainer: mseep
Maintainer-email: mseep <support@skydeck.ai>
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp[cli]>=1.3.0
Requires-Dist: kaggle>=1.5.0
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: maintainer
Dynamic: requires-python

# Kaggle-MCP: Kaggle API Integration for Claude AI

```
     ██╗  ██╗ █████╗  ██████╗  ██████╗ ██╗     ███████╗       ███╗   ███╗ ██████╗██████╗ 
     ██║ ██╔╝██╔══██╗██╔════╝ ██╔════╝ ██║     ██╔════╝       ████╗ ████║██╔════╝██╔══██╗
     █████╔╝ ███████║██║  ███╗██║  ███╗██║     █████╗         ██╔████╔██║██║     ██████╔╝
     ██╔═██╗ ██╔══██║██║   ██║██║   ██║██║     ██╔══╝  ████─  ██║╚██╔╝██║██║     ██╔═══╝ 
     ██║  ██╗██║  ██║╚██████╔╝╚██████╔╝███████╗███████╗       ██║ ╚═╝ ██║╚██████╗██║     
     ╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝  ╚═════╝ ╚══════╝╚══════╝       ╚═╝     ╚═╝ ╚═════╝╚═╝     
```

Kaggle-MCP connects Claude AI to the Kaggle API through the Model Context Protocol (MCP), enabling competition, dataset, and kernel operations through the AI interface.

## Features

- **Authentication**: Securely authenticate with your Kaggle credentials
- **Competitions**: Browse, search, and download data from Kaggle competitions
- **Datasets**: Find, explore, and download datasets from Kaggle
- **Kernels**: Search for and analyze Kaggle notebooks/kernels
- **Models**: Access pre-trained models available on Kaggle

## Quick Installation

The following commands install the base version of Kaggle-MCP.

### macOS / Linux

```bash
# Install with a single command
curl -LsSf https://raw.githubusercontent.com/54yyyu/kaggle-mcp/main/install.sh | sh
```

### Windows

```powershell
# Download and run the installer
powershell -c "Invoke-WebRequest -Uri https://raw.githubusercontent.com/54yyyu/kaggle-mcp/main/install.ps1 -OutFile install.ps1; .\install.ps1"
```

### Manual Installation

```bash
# Install with pip
pip install git+https://github.com/54yyyu/kaggle-mcp.git

# Or better, install with uv
uv pip install git+https://github.com/54yyyu/kaggle-mcp.git
```

## Configuration

After installation, run the setup utility to configure Claude Desktop:

```bash
kaggle-mcp-setup
```

This will locate and update your Claude Desktop configuration file, which is typically found at:
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
- Linux: `~/.config/Claude/claude_desktop_config.json`

### Manual Configuration

Alternatively, you can manually add the following to your Claude Desktop configuration:

```json
{
  "mcpServers": {
    "kaggle": {
      "command": "kaggle-mcp"
    }
  }
}
```

## Kaggle API Credentials

To use Kaggle-MCP, you need to set up your Kaggle API credentials:

1. Go to your [Kaggle account settings](https://www.kaggle.com/settings/account)
2. In the API section, click "Create New API Token"
3. This will download a `kaggle.json` file with your credentials
4. Move this file to `~/.kaggle/kaggle.json` (create the directory if needed)
5. Set the correct permissions: `chmod 600 ~/.kaggle/kaggle.json`

Alternatively, you can authenticate directly through Claude using the `authenticate()` tool with your username and API key.

## Available Tools

For a comprehensive list of available tools and their detailed usage, please refer to the documentation at [stevenyuyy.us/kaggle-mcp](https://stevenyuyy.us/kaggle-mcp).

## Examples

Ask Claude:

- "Authenticate with Kaggle using my username 'username' and key 'apikey'"
- "List active Kaggle competitions"
- "Show me the top 10 competitors on the Titanic leaderboard"
- "Find datasets about climate change"
- "Download the Boston housing dataset"
- "Search for kernels about sentiment analysis"

## Use Cases

- **Competition Research**: Quickly access competition details, data, and leaderboards
- **Dataset Discovery**: Find and download datasets for analysis projects
- **Learning Resources**: Locate relevant kernels and notebooks for specific topics
- **Model Discovery**: Find pre-trained models for various machine learning tasks

## Requirements

- Python 3.8 or newer
- Claude Desktop or API access
- Kaggle account with API credentials
- MCP Python SDK 1.6.0+

## License

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