Reviewguru

io.github.kapruka由 GitHub 帳號 kapruka 發布v0.1.2更新於 Oct 24, 2026

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

發布方自己的服務：Kapruka MCP

已驗證STDIO僅桌面位置與生活網頁搜尋與抓取

概覽

AI 產生的概覽

一個本機 MCP 伺服器，讓助理查詢斯里蘭卡的商家、醫師及其顧客評論，資料來自 Review Guru。

可以做什麼
依城市、類別、評分或新舊列出並排序商家，瀏覽附數量的類別與城市。取得商家完整資料，包括地址、電話、營業時間、評分分布與熱門評論。分頁讀取評論，可依最新、最高、最低或有幫助排序。在所有商家與醫師中做全文搜尋。讀取回傳即時統計的 about 資源。
適用情境
適合助理需要斯里蘭卡餐廳、飯店、商店、沙龍或醫院的推薦，或需要附專科與執業地點的醫師資料並搭配顧客評論時使用。在斯里蘭卡以外地區用處不大。
執行需求
透過 stdio 在本機執行，可用 uvx、pipx 或 pip 安裝，需要 Python 環境。不需 API 金鑰。會呼叫公開的 HTTPS 端點，因此需要網路存取。選用環境變數 REVIEWGURU_API 與 REVIEWGURU_URL 可覆寫 API 基礎位址與輸出中的商家連結；DATABASE_URL 僅供維護者使用。
安裝前請注意
公開 API 為共用資源，有輕度限流（每個 IP 每分鐘 60 次請求）；用量更大需自行部署。評論僅允許在註明來源 Review Guru 並連結回特定商家頁面的前提下引用。設定 REVIEWGURU_API 或 DATABASE_URL 會讓伺服器指向其他資料來源，請只使用可信的值。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Reviewguru，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

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.

來源：README.md，提交 8aa369e

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.2最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Kapruka 整合

Kapruka MCP

com.kapruka官方發布者

讓助理搜尋 Kapruka.com 商品、查配送、建立訂單並追蹤出貨。

Streamable HTTP可網頁執行
效率與工作流10 個工具Oct 24, 2026