使用说明

项目简介

本项目 'Kaggle MCP Server' 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在桥接 AI 助手（如 Claude）与 Kaggle 平台。通过此服务器，AI 助手可以调用预设的工具，方便快捷地完成 Kaggle 竞赛相关的操作，例如浏览竞赛列表、下载竞赛数据、提交预测结果以及查看提交历史等。这使得数据科学家和AI爱好者能够更高效地利用 AI 助手参与 Kaggle 竞赛，提升工作效率和智能化水平。

主要功能点

浏览竞赛列表: 获取当前 Kaggle 上的所有活跃竞赛信息，并支持关键词搜索和分页浏览。
下载竞赛数据: 下载指定 Kaggle 竞赛的数据文件到本地，方便进行数据分析和模型训练。
提交竞赛结果: 将本地的预测结果文件提交到指定的 Kaggle 竞赛，参与竞赛评比。
查看提交记录: 查询指定 Kaggle 竞赛的提交历史，包括提交时间、状态和得分等信息。

安装步骤

克隆仓库

git clone https://github.com/Dishant27/kaggle-MCP.git
cd kaggle-MCP

安装依赖

确保已安装 Node.js (16 或更高版本) 和 npm。然后运行：
```
npm install
```
构建项目
```
npm run build
```

服务器配置

要将此 MCP 服务器连接到 MCP 客户端（例如 Claude for Desktop），您需要在客户端的配置文件中添加以下服务器配置信息。通常，配置文件名为 'claude_desktop_config.json'。

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

配置参数说明:

'"kaggle"': 服务器名称，可以自定义，用于在客户端中标识该服务器。
'"command": "node"': 启动服务器的命令，这里使用 Node.js 运行。
'"args": ["/path/to/kaggle-MCP/build/index.js"]': 启动命令的参数，指向构建后的服务器入口文件 'index.js'。 请将 '/path/to/kaggle-MCP' 替换为您的 'kaggle-MCP' 仓库的实际路径。
'"env"': 环境变量配置，用于配置 Kaggle API 认证信息。
- '"KAGGLE_USERNAME": "你的Kaggle用户名"': 您的 Kaggle 用户名，请替换为您的实际用户名。
- '"KAGGLE_KEY": "你的Kaggle API密钥"': 您的 Kaggle API 密钥，请替换为您的实际 API 密钥。您可以在 Kaggle 账户设置页面 (https://www.kaggle.com/account) 创建 API 密钥。

注意: 除了在 'claude_desktop_config.json' 中配置 Kaggle API 密钥，您也可以选择使用标准的 'kaggle.json' 文件进行认证。具体方法请参考仓库 README 文档中的 "Authentication Setup" 部分。

基本使用方法

启动 MCP 服务器后，在您的 MCP 客户端（例如 Claude for Desktop）中选择配置好的 "kaggle" 服务器，即可通过自然语言指令与 Kaggle 平台互动。

示例指令:

"Show me the active Kaggle competitions" (显示活跃的 Kaggle 竞赛)
"Search for image classification competitions" (搜索图像分类竞赛)
"Download the files for the Titanic competition" (下载泰坦尼克号竞赛的文件)
"Submit my predictions.csv file to the housing-prices competition with the message 'Random forest model'" (提交我的 predictions.csv 文件到房价预测竞赛，提交信息为 'Random forest model')
"Show me my submissions for the digit-recognizer competition" (显示我在数字识别竞赛中的提交记录)

请根据您的 AI 助手的功能和指令格式进行提问，即可使用上述功能。

关键词