Happy slice of mcp pizzaMCP.pizza

mcp

MCP.Pizza Chef: kapruka

This MCP server connects your AI assistant to Kapruka.com’s shopping platform by wrapping its online store API. Once set up, your AI can access product listings, order information, and other shopping data from Kapruka.com. It requires some developer setup with Python and configuration of your Kapruka API credentials. Compatible with MCP clients like MCP Inspector and Claude Desktop, it enables AI-powered shopping tasks within those apps.

Other

Use This MCP server To

Connect my AI to Kapruka.com to browse products Fetch order details from Kapruka.com via AI Manage Kapruka.com shopping data with AI Test Kapruka API integration using MCP Inspector

README

Kapruka MCP Server

Python MCP server that wraps the Kapruka.com REST API and exposes it as tools for LLMs and third-party MCP clients.

Setup

# 1. Create and activate a virtual environment
python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate

# 2. Install dependencies
pip install -e ".[dev]"

# 3. Configure environment
cp .env.example .env
# Edit .env with your Kapruka API URL and key

Running

# Start the MCP server (streamable HTTP, default port 8000)
python cli.py server

# Start with stdio transport (for use with MCP Inspector)
python cli.py server --stdio

# Health-check the Kapruka REST API
python cli.py ping

# List registered MCP tools
python cli.py tools

Testing with MCP Inspector

npx @modelcontextprotocol/inspector python cli.py server --stdio

Project Structure

src/
  server.py        # FastMCP server entry point
  tools/           # One module per tool group (products, orders, …)
  api/
    client.py      # Async httpx client + error handling
  config/
    settings.py    # Env-based configuration
tests/             # pytest test suite
cli.py             # Developer CLI

Running Tests

pytest

mcp FAQ

Can I use this to access Kapruka.com product and order data?
Yes — this server connects your AI to Kapruka.com to fetch and manage products and orders.
Do I need an API key to use this server?
Yes — you must provide your Kapruka API URL and key in the configuration to connect.
Which apps can use this MCP server?
It can be used with any MCP-compatible client that supports custom servers, such as MCP Inspector, Claude Desktop, or ChatGPT with MCP support.
How hard is it to set up?
It requires developer-level setup including Python environment and configuration edits.
Can I run this server without installing anything?
No — you need Python and some setup steps to run the server locally.