kaggle-mcp-server

此项目提供了一个MCP（模型上下文协议）服务器，用于与Claude Desktop（或任何兼容MCP的客户端）交互。

🚀 安装

1. 克隆仓库并安装依赖

 pip install -r requirements.txt

2. 配置Kaggle API凭证

  前往您的Kaggle账户 -> 设置
  
  滚动到API部分 → 点击创建新API令牌。
  这将下载一个名为kaggle.json的文件。

  将kaggle.json放置在系统中的以下位置：
  
  Linux/Mac:
  
  ~/.kaggle/kaggle.json
  
  Windows:
  
  C:\Users\<您的用户名>\.kaggle\kaggle.json

3. 配置Claude Desktop

 要连接Claude与此MCP服务器，请创建或更新以下文件：
 
 Claude/claude_desktop_config.json
 
 文件内容如下：
 
 {
   "mcpServers": {
     "Kaggle": {
       "command": "<您的Python可执行文件路径>",
       "args": ["<您的kaggle-server.py文件路径>"]
     }
   }
 }
 
 将<您的Python可执行文件路径>替换为您Python解释器的路径（例如：python 或 C:/Python/python.exe）。
 
 将<您的kaggle-server.py文件路径>替换为此仓库的kaggle-server.py文件路径。

📜 使用方法

 配置完成后：
 
 启动Claude Desktop。
 
 启动Kaggle MCP服务器（作为Python文件运行kaggle-server.py）。
 
 您现在可以使用kaggle-server.py中定义的MCP工具，例如：
 
 get_competitions_list: 获取可用的Kaggle竞赛列表，并以适合JSON的格式返回它们。

🛠️ 关于代码

 kaggle-server.py使用@mcp.tool()装饰器注册MCP工具。
 
 服务器通过MCP与Claude通信，并公开Kaggle API方法。
 
 示例工具：
 
 @mcp.tool()
 def get_competitions_list() -> list[dict]:
     """
     获取可用的Kaggle竞赛列表。
     """

✅ 要求

  Python 3.10+
      
  Kaggle API凭证（kaggle.json）
      
  requirements.txt中列出的依赖项

🔒 安全注意事项

 切勿提交您的kaggle.json文件。
 
 确保.kaggle文件夹具有受限权限。