Kaggle-MCP: Claude AI 的 Kaggle API 集成

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

Kaggle-MCP 通过模型上下文协议 (MCP) 将 Claude AI 与 Kaggle API 连接起来，使用户能够通过 AI 界面进行竞赛、数据集和内核操作。

功能

• 认证：使用您的 Kaggle 凭证安全地进行认证
• 竞赛：浏览、搜索并从 Kaggle 竞赛中下载数据
• 数据集：查找、探索并下载 Kaggle 上的数据集
• 内核：搜索并分析 Kaggle 笔记本/内核
• 模型：访问 Kaggle 上可用的预训练模型

快速安装

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

macOS / Linux

bash

使用单个命令安装

curl -LsSf https://raw.githubusercontent.com/54yyyu/kaggle-mcp/main/install.sh | sh

Windows

powershell

下载并运行安装程序

powershell -c "Invoke-WebRequest -Uri https://raw.githubusercontent.com/54yyyu/kaggle-mcp/main/install.ps1 -OutFile install.ps1; .install.ps1"

手动安装

bash

使用 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：

bash
kaggle-mcp-setup

这将会定位并更新您的 Claude Desktop 配置文件，该文件通常位于：

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

手动配置

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

json
{
"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

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

可用工具

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

示例

询问 Claude：

• “使用我的用户名 username 和密钥 apikey 对 Kaggle 进行认证”- "列出活跃的Kaggle竞赛"
• "显示泰坦尼克号排行榜上前10名的参赛者"
• "查找关于气候变化的数据集"
• "下载波士顿房价数据集"
• "搜索关于情感分析的内核"

用例

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

要求

• Python 3.8 或更高版本
• Claude 桌面版或 API 访问权限
• 具有 API 凭证的 Kaggle 账户
• MCP Python SDK 1.6.0 或更高版本

许可证

本项目根据 MIT 许可证发布 - 有关详细信息，请参阅 LICENSE 文件。