Kaggle-MCP：用于 Claude AI 的 Kaggle API 集成

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

Kaggle-MCP 通过模型上下文协议 (MCP) 将 Claude AI 连接到 Kaggle API，从而可以通过 AI 界面实现竞赛、数据集和内核操作。

特性

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

快速安装

以下命令安装 Kaggle-MCP 的基本版本。

macOS / Linux

# 使用单个命令安装
curl -LsSf https://raw.githubusercontent.com/54yyyu/kaggle-mcp/main/install.sh | sh

Windows

# 下载并运行安装程序
powershell -c "Invoke-WebRequest -Uri https://raw.githubusercontent.com/54yyyu/kaggle-mcp/main/install.ps1 -OutFile install.ps1; .\install.ps1"

手动安装

# 使用 pip 安装
pip install git+https://github.com/54yyyu/kaggle-mcp.git

# 或者更好，使用 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 部分，单击“创建新的 API 令牌”
3. 这将下载一个包含您的凭据的 kaggle.json 文件
4. 将此文件移动到 ~/.kaggle/kaggle.json（如果需要，创建目录）
5. 设置正确的权限：chmod 600 ~/.kaggle/kaggle.json

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

可用工具

有关可用工具及其详细用法的完整列表，请参阅 stevenyuyy.us/kaggle-mcp 上的文档。

示例

询问 Claude：

• "使用我的用户名 'username' 和密钥 'apikey' 验证 Kaggle"
• "列出活跃的 Kaggle 竞赛"
• "向我展示泰坦尼克号排行榜上的前 10 名竞争者"
• "查找有关气候变化的数据集"
• "下载波士顿房价数据集"
• "搜索有关情感分析的内核"

用例

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

要求

• Python 3.8 或更高版本
• Claude Desktop 或 API 访问
• 具有 API 凭据的 Kaggle 帐户
• MCP Python SDK 1.6.0+

许可证

该项目已获得 MIT 许可证的许可 - 有关详细信息，请参阅 LICENSE 文件。