{
  "markdown": "# Kapruka MCP Server\n\nPython MCP server that wraps the Kapruka.com REST API and exposes it as tools for LLMs and third-party MCP clients.\n\n## Setup\n\n```bash\n# 1. Create and activate a virtual environment\npython -m venv .venv\nsource .venv/bin/activate   # Windows: .venv\\Scripts\\activate\n\n# 2. Install dependencies\npip install -e \".[dev]\"\n\n# 3. Configure environment\ncp .env.example .env\n# Edit .env with your Kapruka API URL and key\n```\n\n## Running\n\n```bash\n# Start the MCP server (streamable HTTP, default port 8000)\npython cli.py server\n\n# Start with stdio transport (for use with MCP Inspector)\npython cli.py server --stdio\n\n# Health-check the Kapruka REST API\npython cli.py ping\n\n# List registered MCP tools\npython cli.py tools\n```\n\n## Testing with MCP Inspector\n\n```bash\nnpx @modelcontextprotocol/inspector python cli.py server --stdio\n```\n\n## Project Structure\n\n```\nsrc/\n  server.py        # FastMCP server entry point\n  tools/           # One module per tool group (products, orders, …)\n  api/\n    client.py      # Async httpx client + error handling\n  config/\n    settings.py    # Env-based configuration\ntests/             # pytest test suite\ncli.py             # Developer CLI\n```\n\n## Running Tests\n\n```bash\npytest\n```\n",
  "bytes": 1229,
  "sha": "491cdd5b5d94a1c47f5fe16602b724ce8e156eb90e600c7db81ec813f57b57a8",
  "repo_slug": "kapruka/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_kapruka_kapruka_mcp_63a72efc/readme"
}