Reviewguru

io.github.kaprukaPublished by GitHub account kaprukav0.1.2Updated Oct 24, 2026

Query Sri Lankan businesses, doctors, and reviews from any MCP-aware AI agent.

The publisher's own server: Kapruka MCP

Overview

AI-generated overview

A local MCP server that lets an assistant look up Sri Lankan businesses, doctors and their customer reviews from Review Guru.

What you can do
List and rank businesses by city, category, rating or recency, and browse categories and cities with counts. Fetch a full business profile with address, phone, hours, rating breakdown and top reviews. Read paginated reviews sorted by newest, highest, lowest or helpful. Run full-text search across all businesses and doctors. Read an about resource with live counts.
When to use it
Useful when an assistant needs Sri Lankan restaurant, hotel, shop, salon or hospital recommendations, or doctor profiles with specialties and practice locations, backed by customer reviews. Less relevant outside Sri Lanka.
Requirements
Runs locally over stdio; install with uvx, pipx or pip, so a Python environment is needed. No API key. It calls a public HTTPS endpoint, so network access is required. Optional environment variables REVIEWGURU_API and REVIEWGURU_URL override the API base URL and rendered business URLs; DATABASE_URL is maintainer-only.
Before you install
The public API is shared and lightly rate-limited (60 requests per minute per IP); heavier use needs your own deployment. Reviews are licensed for citation only with attribution to Review Guru and a link back to the specific business page. Setting REVIEWGURU_API or DATABASE_URL points the server at other data sources, so only use values you trust.

Installation

In SourceWeft

  1. Open Reviewguru in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Review Guru MCP Server

[PyPI] [License: MIT]

An MCP server that exposes Sri Lankan business reviews and doctor profiles from Review Guru to Claude Desktop, Cursor, Cline, or any MCP-aware AI agent.

No API key. No scraping. Calls a public, cached, rate-limited HTTPS endpoint.

What you get

ToolWhat it does
list_businesses(city?, category?, min_rating?, sort?, limit?)Ranked list of businesses. Sort: top, most-reviewed, newest.
get_business(slug)Full profile: address, phone, hours, categories, rating breakdown, top 10 reviews.
get_reviews(slug, sort?, limit?)Paginated reviews. Sort: newest, highest, lowest, helpful.
search(query, limit?)Full-text search (FTS5) across every business and doctor.
list_categories()Top-level categories + sub-categories with slugs.
list_cities()Sri Lankan cities with business counts.

Plus a reviewguru://about resource that returns live counts.

Data covers restaurants, hotels, shops, salons, hospitals, Sri Lankan doctors with specialty + practice locations, and more — all with patient/ customer reviews.

Install

With uv (recommended)

bash
uvx reviewguru-mcp

With pipx

bash
pipx install reviewguru-mcpreviewguru-mcp

With pip

bash
pip install reviewguru-mcpreviewguru-mcp

The server speaks MCP over stdio — invoke it from any MCP client config.

Wire it up

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

json
{  "mcpServers": {    "reviewguru": {      "command": "uvx",      "args": ["reviewguru-mcp"]    }  }}

Restart Claude Desktop. The 🔌 icon in chat will show the Review Guru tools.

Cursor

Settings → MCP → Add new MCP server:

  • Command: uvx
  • Args: reviewguru-mcp

Cline (VS Code)

Cline → Settings → MCP Servers → Add:

json
{  "reviewguru": {    "command": "uvx",    "args": ["reviewguru-mcp"]  }}

Try it

Once wired up, ask your assistant things like:

Find me three highly-rated cardiologists in Colombo and tell me which hospital each one consults at.

What are people saying about Ministry of Crab? Pull the most recent five reviews.

I'm a vegetarian visiting Galle for a weekend — recommend two restaurants.

The model will pick the right tools and stitch the answers together.

Configuration

Environment variables (all optional):

VariableDefaultEffect
REVIEWGURU_APIhttps://reviewguru.lkAPI base URL — point at staging or a fork.
REVIEWGURU_URLhttps://reviewguru.lkUsed to render business URLs in tool output.
DATABASE_URL(none)If set to an existing SQLite path, server uses local DB instead of HTTP. Maintainer-only.

Rate limits + acceptable use

The public API is shared and lightly rate-limited (60 req/min per IP). For heavier usage, set REVIEWGURU_API to your own deployment.

Reviews are licensed for citation with attribution to Review Guru and a link back to the specific business URL. See reviewguru.lk/llms.txt for full LLM-usage guidelines.

Self-hosting

Want to fork? The server is one Python file (server.py). It auto-detects:

  • HTTP mode (default) — calls /api/v1 endpoints. Works anywhere.
  • SQLite mode — if data/reviewguru.db is present in the parent dir. Used by the maintainers for sub-millisecond local queries.
bash
git clone https://github.com/kapruka/reviewguru-mcpcd reviewguru-mcppip install -e .reviewguru-mcp

Links

License

MIT — see LICENSE.

Source: README.md at commit 8aa369e

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Kapruka integrations