https://github.com/54yyyu/kaggle-mcp
Kaggle-MCP: Connect Claude AI to the Kaggle API through the Model Context Protocol (MCP), enabling competition, dataset, and kernel operations through the AI interface.
https://github.com/54yyyu/kaggle-mcp
claude-ai kaggle mcp mcp-server
Last synced: 6 months ago
JSON representation
Kaggle-MCP: Connect Claude AI to the Kaggle API through the Model Context Protocol (MCP), enabling competition, dataset, and kernel operations through the AI interface.
- Host: GitHub
- URL: https://github.com/54yyyu/kaggle-mcp
- Owner: 54yyyu
- License: mit
- Created: 2025-04-06T14:55:21.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-04-06T21:54:13.000Z (6 months ago)
- Last Synced: 2025-04-13T08:12:17.980Z (6 months ago)
- Topics: claude-ai, kaggle, mcp, mcp-server
- Language: Python
- Homepage: http://stevenyuyy.us/kaggle-mcp
- Size: 49.8 KB
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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.