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