Kaggle MCP

🚀 Kaggle MCP 服务器

Kaggle MCP 服务器是一个基于模型上下文协议（MCP）的工具，可借助 Claude 或其他兼容的 AI 助手，实现与 Kaggle 竞赛的交互，为数据科学竞赛提供便利。

🚀 快速开始

先决条件

• Node.js 16 或更高版本
• TypeScript
• 已安装的 Kaggle CLI（pip install kaggle）
• 配置好的 Kaggle API 凭证

认证设置

有两种方式与 Kaggle API 认证：

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

1. 安装 Kaggle CLI：

pip install kaggle

2. 访问 Kaggle 账户页面 并点击“创建新的 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 Desktop 配置（更简单）

你可以直接将 Kaggle 凭证添加到 claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "kaggle": {
      "command": "node",
      "args": ["/path/to/build/index.js"],
      "env": {
        "KAGGLE_USERNAME": "你的Kaggle用户名",
        "KAGGLE_KEY": "你的Kaggle API密钥"
      }
    }
  }
}

请替换 你的Kaggle用户名 和 你的Kaggle API密钥。

安装

从 GitHub 克隆仓库：

git clone https://github.com/yourusername/kaggle-mcp-server.git
cd kaggle-mcp-server
npm install

使用说明

初始化服务器

node index.js

提交到竞赛

curl -X POST http://localhost:3000/api/submit \
  -F "file=@your_predictions.csv" \
  -F "competition_id=abc123"

✨ 主要特性

之前列出的所有“即将推出”的功能现在都包含在 feature-complete 分支中，其中包括：

• 数据集操作：浏览、搜索、下载和分析 Kaggle 上的数据集。
• 笔记本集成：直接从 AI 助手工作与 Kaggle notebooks。
• 用户管理：查看个人资料信息并检查比赛排名。
• 竞赛分析：获取详细的竞赛指标和排行榜见解。

请参阅 feature-complete 分支以获取最新和最全面的 Kaggle MCP 服务器实现。

📖 详细文档

想了解此服务器的全部潜力？查看详细文章：人工智能驱动的数据科学革命：如何通过 Kaggle MCP 服务器转变 AI 能力

📄 许可证

本项目采用 MIT 许可证。