Kapruka MCP

Kapruka MCP サーバー

Kapruka.com REST API をラップし、LLM とサードパーティの MCP クライアント向けのツールとして公開する Python 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 のデプロイ手順を参照してください。

テストの実行

pytest