Kapruka MCP
Free public MCP server for Kapruka.com — Sri Lanka's largest e-commerce platform.
Open source Repository Open in the app JSON README (API)
About
Free public MCP server for Kapruka.com — Sri Lanka's largest e-commerce platform.
Details
- Kind
- MCP servers
- Topic
- E-commerce & business
- Publisher
- com.kapruka
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 0.2.2
- Stars
- 21
- Forks
- 15
- Open pull requests
- 2
- Last push
- 2026-08-15T04:02:19Z
- Repository state
- ativo
- Language
- Python
- Added
- 2026-08-29 03:01:12
- Updated
- 2026-08-29 03:01:12
- Origin id
com.kapruka/kapruka-mcp
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
```bash
# 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
```bash
# 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
```bash
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
```bash
pytest
```