MatMCP

# MatMCP 🛒 An MCP (Model Context Protocol) server that provides AI assistants with tools to interact with Mathem.se, a Swedish online grocery store. Search for ingredients, add items to your basket, and manage recipes directly through your AI assistant. ## Features - **Search Ingredients**: Find products on Mathem.se by name or description - **Add to Basket**: Add products directly to your Mathem.se shopping cart - **Recipe Management**: List and fetch detailed recipe information - **Structured Data**: Get clean, structured product and recipe data ## Prerequisites - **macOS/Linux**: This guide assumes macOS, but Linux instructions are similar - **Python 3.12+**: Required for the project - **uv**: Fast Python package manager - **Mathem.se Account**: For adding items to basket functionality ## Installation ### 1. Install uv (Python package manager) ```bash brew install uv ``` ### 2. Clone and setup the project ```bash git clone <your-repo-url> cd matmcp ``` ### 3. Install dependencies ```bash uv sync ``` ### 4. Configure Mathem.se authentication (optional) For basket functionality, you need to provide your Mathem.se session cookies: 1. Copy the example cookie file: ```bash cp cookie.txt.example cookie.txt ``` 2. Get your session cookies from Mathem.se: - Open your browser and go to [mathem.se](https://www.mathem.se) - Log in to your account - Open Developer Tools (F12) - Go to the Network tab - Refresh the page - Find a request to mathem.se and copy the Cookie header value - Paste it into `cookie.txt` The format should look like: ``` sessionid=your_session_id_here; csrftoken=your_csrf_token_here; other_cookies=value ``` **Note**: Without cookies, you can still search for ingredients, but adding to basket will not work. ## Claude Desktop Integration Add this MCP server to your Claude Desktop configuration: ### 1. Open Claude Desktop config ```bash # macOS open ~/Library/Application\ Support/Claude/claude_desktop_config.json # Linux open ~/.config/claude/claude_desktop_config.json ``` ### 2. Add the server configuration Replace `/YOUR/PATH/TO/matmcp` with your actual project directory: ```json { "mcpServers": { "mathem": { "command": "uv", "args": [ "--directory", "/YOUR/PATH/TO/matmcp", "run", "mathem.py" ] } } } ``` ### 3. Restart Claude Desktop Close and reopen Claude Desktop to load the new MCP server. ## Usage Once configured, you can ask Claude to: - **Search for ingredients**: "Find organic tomatoes on Mathem" - **Add items to basket**: "Add 2 packages of pasta to my Mathem basket" - **Get recipes**: "Show me the available recipes" - **Recipe details**: "Get the details for recipe number 1" ## Available Tools ### `search_mathem_ingredients(query: str)` Search for products on Mathem.se **Example**: Search for "organic milk" ### `add_to_mathem_basket(product_id: int, quantity: int = 1)` Add a product to your Mathem.se shopping basket **Requirements**: Valid session cookies in `cookie.txt` ### `list_recipes()` List all available recipes from `recipes.csv` ### `get_recipe_by_index(index: int)` Get detailed recipe information by index ## Development ### Running tests ```bash uv run pytest ``` ### Running the server directly ```bash uv run mathem.py ``` ### Adding recipes Edit `recipes.csv` to add new recipes with columns: `id`, `title`, `url` ## License This project is for educational and personal use. Please respect Mathem.se's terms of service when using this tool.