Kaggle-MCP: Kaggle API Integration for Claude AI

Kaggle-MCP：面向 Claude AI 的 Kaggle API 集成

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

Kaggle-MCP 通过模型上下文协议（MCP）将 Claude AI 连接到 Kaggle API，让你通过 AI 界面进行竞赛、数据集和内核操作。

功能

• 身份验证：使用 Kaggle 凭据进行安全身份验证
• 竞赛：浏览、搜索和下载 Kaggle 竞赛数据
• 数据集：查找、探索和下载 Kaggle 数据集
• 内核：搜索和分析 Kaggle 笔记本／内核
• 模型：访问 Kaggle 上提供的预训练模型

快速安装

以下命令用于安装 Kaggle-MCP 基础版本。

macOS / Linux

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

Windows

# 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"

手动安装

# 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

配置

安装后，运行设置工具以配置 Claude Desktop：

kaggle-mcp-setup

该工具会查找并更新 Claude Desktop 配置文件，该文件通常位于：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

手动配置

或者，你也可以手动将以下内容添加到 Claude Desktop 配置中：

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

Kaggle API 凭据

要使用 Kaggle-MCP，你需要设置 Kaggle API 凭据：

1. 前往你的 Kaggle 账户设置
2. 在 API 部分，点击“Create New API Token”
3. 系统会下载包含你凭据的 kaggle.json 文件
4. 将此文件移至 ~/.kaggle/kaggle.json（如有需要，请创建该目录）
5. 设置正确的权限：chmod 600 ~/.kaggle/kaggle.json

或者，你也可以通过 Claude 使用 authenticate() 工具和你的用户名、API 密钥直接进行身份验证。

可用工具

如需查看可用工具的完整列表及其详细用法，请参阅文档：stevenyuyy.us/kaggle-mcp。

示例

向 Claude 提问：

• “使用我的用户名 'username' 和密钥 'apikey' 通过 Kaggle 进行身份验证”
• “列出当前活跃的 Kaggle 竞赛”
• “给我看看 Titanic 排行榜上排名前 10 的参赛者”
• “查找有关气候变化的数据集”
• “下载波士顿房价数据集”
• “搜索有关情感分析的内核”

使用场景

• 竞赛研究：快速访问竞赛详情、数据和排行榜
• 数据集发现：查找并下载用于分析项目的数据集
• 学习资源：查找特定主题的相关内核和笔记本
• 模型发现：查找适用于各种机器学习任务的预训练模型

要求

• Python 3.8 或更高版本
• Claude Desktop 或 API 访问权限
• 拥有 API 凭据的 Kaggle 账户
• MCP Python SDK 1.6.0+

许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。