<img src="https://www.kaggle.com/static/images/site-logo.svg" alt="Kaggle Logo" width="80" height="24"> Kaggle MCP 服务器

一个模型上下文协议 (MCP) 服务器，用于通过 Claude 或其他兼容的 AI 助手与 Kaggle 竞赛进行交互。

📖 了解更多

想了解此服务器的全部潜力？请查看详细文章：

AI 驱动的数据科学革命：Kaggle MCP 服务器如何改变 AI 能力

前提条件

• Node.js 16 或更高版本
• TypeScript
• 已安装 Kaggle CLI (pip install kaggle)
• 已配置 Kaggle API 凭据

身份验证设置

有两种方法可以使用 Kaggle API 进行身份验证：

选项 1：使用 kaggle.json 文件（标准方法）

1. 安装 Kaggle CLI：

pip install kaggle

2. 转到 https://www.kaggle.com/account 并单击“创建新的 API 令牌”
3. 这将下载一个包含您的凭据的 kaggle.json 文件
4. 在您的主文件夹中创建一个 .kaggle 目录（如果它不存在）

# 在 Linux/Mac 上
mkdir -p ~/.kaggle

# 在 Windows 上 (PowerShell)
New-Item -ItemType Directory -Force -Path "$HOME\.kaggle"

5. 将下载的 kaggle.json 文件移动到 .kaggle 目录：

# 在 Linux/Mac 上
mv ~/Downloads/kaggle.json ~/.kaggle/
chmod 600 ~/.kaggle/kaggle.json  # 设置权限

# 在 Windows 上 (PowerShell)
Move-Item -Path "$HOME\Downloads\kaggle.json" -Destination "$HOME\.kaggle\kaggle.json"

选项 2：使用 Claude for Desktop 配置（更简单）

您可以直接将您的 Kaggle 凭据添加到您的 claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "kaggle": {
      "command": "node",
      "args": ["/path/to/build/index.js"],
      "env": {
        "KAGGLE_USERNAME": "your-kaggle-username",
        "KAGGLE_KEY": "your-kaggle-api-key"
      }
    }
  }
}

将 your-kaggle-username 和 your-kaggle-api-key 替换为您的实际 Kaggle 凭据。

安装

1. 克隆此存储库
2. 安装依赖项：

npm install

3. 构建项目：

npm run build

用法

运行服务器

npm start

或者直接：

node build/index.js

与 Claude for Desktop 连接

将以下配置添加到您的 claude_desktop_config.json 文件。

示例查询

连接到 Claude 后，您可以提出如下问题：

• "显示我活跃的 Kaggle 竞赛"
• "搜索图像分类竞赛"
• "下载 Titanic 竞赛的文件"
• "将我的 predictions.csv 文件提交到 housing-prices 竞赛，并附带消息 'Random forest model'"
• "显示我 digit-recognizer 竞赛的提交"

故障排除

身份验证问题

如果您遇到身份验证错误：

1. 验证您的凭据是否已正确设置：

   • 如果使用 kaggle.json，请检查它是否位于正确的位置：
     • Linux/Mac: ~/.kaggle/kaggle.json
     • Windows: C:\Users\<USERNAME>\.kaggle\kaggle.json
   • 如果使用环境变量，请检查 claude_desktop_config.json 中的 env 部分

2. 对于 kaggle.json，检查文件是否具有正确的权限：

   • 在 Linux/Mac 上，运行：chmod 600 ~/.kaggle/kaggle.json

3. 确保您的 API 令牌仍然有效。如果需要，请从您的 Kaggle 帐户页面生成一个新的令牌。

安装问题

如果找不到 Kaggle CLI：

1. 确保您已使用以下命令安装它：pip install kaggle
2. 通过运行 kaggle --version 验证 Kaggle 命令是否在您的 PATH 中

当前功能

该服务器目前为 Kaggle 竞赛提供以下操作：

🔍 列出竞赛

• 列出所有活跃的 Kaggle 竞赛
• 按关键字搜索竞赛
• 支持分页以浏览结果
• 显示竞赛详细信息，包括名称、类别、截止日期和奖金

📥 下载竞赛文件

• 下载任何竞赛的文件
• 指定自定义下载路径
• 强制重新下载现有文件
• 适用于所有公共竞赛数据集

📤 提交到竞赛

• 将预测文件提交到竞赛
• 添加自定义提交消息
• 获取有关提交状态的即时反馈
• 需要事先在 Kaggle 网站上接受竞赛规则

📋 列出提交

• 查看特定竞赛的提交历史记录
• 查看提交状态和分数
• 跟踪一段时间内的多个提交

所有功能现已可用

先前列为“即将推出”的所有功能现在都可以在此存储库的 feature-complete 分支中使用。这包括：

• 数据集操作：浏览、搜索、下载和分析来自 Kaggle 的数据集
• Notebook 集成：直接从您的 AI 助手处理 Kaggle notebook
• 用户管理：检查个人资料信息和竞赛排名
• 竞赛分析：获取详细的竞赛指标和排行榜见解

查看 feature-complete 分支，以获取 Kaggle MCP 服务器的最新和最全面的实现。

许可证

MIT