Kapruka MCP

Name: Kapruka MCP
Author: kapruka.com

远程服务

mcp.kapruka.com商业与营销211 周前更新

代码仓库访问官网

关于 Kapruka MCP

Kapruka MCP 是一个免费公开的 MCP 服务，封装了斯里兰卡电商平台 Kapruka.com 的 REST API，供 LLM 和第三方 MCP 客户端调用。

主要功能

01封装 Kapruka.com REST API 为工具
02支持流式 HTTP 与 stdio 传输
03提供 REST API 健康检查命令
04支持合作伙伴密钥认证

适用场景

01让 LLM 通过 Kapruka.com 查询商品或订单
02在 MCP Inspector 中测试 Kapruka 接口

MCP 相关

该项目是一个 Python MCP 服务，向 MCP 客户端暴露 Kapruka 相关工具，并可通过 HTTP 或 stdio 连接。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://mcp.kapruka.com/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http com-kapruka-kapruka https://mcp.kapruka.com/mcp

Cursor.cursor/mcp.json{"mcpServers":{"com-kapruka-kapruka":{"type":"http","url":"https://mcp.kapruka.com/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"com-kapruka-kapruka":{"type":"http","url":"https://mcp.kapruka.com/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"com-kapruka-kapruka":{"type":"http","url":"https://mcp.kapruka.com/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"com-kapruka-kapruka":{"serverUrl":"https://mcp.kapruka.com/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

参数	类型	必填	说明
params	any	是

详细介绍

Kapruka MCP 服务

Python MCP 服务，用于封装 Kapruka.com REST API，并将其作为工具提供给大模型和第三方 MCP 客户端。

设置

# 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

运行

# 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

使用 MCP Inspector 测试

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

项目结构

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

受信任的合作伙伴

无法通过 IP 白名单进行限制的第一方调用方（例如运行在 Cloudflare Workers 上的 Kapruka 网页助手）改用 X-Partner-Key 请求头进行身份验证，并可通过 X-Partner-Customer-Id 设置按客户划分的限制。通过 PARTNER_KEYS / PARTNER_SCOPES / PARTNER_LIMITS 配置。请参阅 docs/PARTNER_ACCESS.md 和 deploy/README.md 中的部署步骤。