# kaggle-mcp-server
This project provides an MCP (Model Context Protocol) server for interacting with Kaggle from Claude Desktop (or any MCP-compatible client)

# 🚀 Setup
# 1. Clone the repository and install dependencies
     pip install -r requirements.txt

# 2. Configure Kaggle API credentials

      Go to your Kaggle account -> Settings
      
      Scroll to API section → click Create New API Token.
      This will download a file called kaggle.json.

      Place kaggle.json in the following location on your system:
      
      Linux/Mac:
      
      ~/.kaggle/kaggle.json
      
      Windows:
      
      C:\Users\<your-username>\.kaggle\kaggle.json

# 3. Configure Claude Desktop

     To connect Claude with this MCP server, create or update the file:
     
     Claude/claude_desktop_config.json
     
     with the following contents:
     
     {
       "mcpServers": {
         "Kaggle": {
           "command": "<path-to-your-python-executable>",
           "args": ["<path-to-your-kaggle-server.py>"]
         }
       }
     }
     
     Replace <path-to-your-python-executable> with the path to your Python interpreter (e.g. python or C:/Python/python.exe).
     
     Replace <path-to-your-kaggle-server.py> with the path to this repo’s kaggle-server.py file.

# 📜 Usage

     Once configured:
     
     Start Claude Desktop.
     
     Start the Kaggle MCP server (Run kaggle-server.py as a Python File).
     
     You can now use MCP tools defined in kaggle-server.py, for example:
     
     get_competitions_list: Fetches the list of available Kaggle competitions and returns them in a JSON-friendly format.

# 🛠️ About the Code

     kaggle-server.py registers MCP tools using the @mcp.tool() decorator.
     
     The server communicates with Claude via MCP and exposes Kaggle API methods.
     
     Example tool:
     
     @mcp.tool()
     def get_competitions_list() -> list[dict]:
         """
         Fetch the list of available Kaggle competitions.
         """

# ✅ Requirements

      Python 3.10+
          
      Kaggle API credentials (kaggle.json)
          
      Dependencies listed in requirements.txt

# 🔒 Security Notes

     Never commit your kaggle.json file.
     
     Ensure the .kaggle folder has restricted permissions.