Posokanei Mcp

io.github.charistas由 GitHub 帳號 charistas 發布v0.1.1更新於 Nov 3, 2026

Unofficial read-only MCP server for Greek supermarket price data from PosoKanei.

已驗證STDIO僅桌面金融商業與電商

概覽

AI 產生的概覽

非官方唯讀 MCP 伺服器,讓助理透過 PosoKanei 搜尋希臘超市商品、依條碼查詢並比較各零售商的價格。

可以做什麼
  • 依文字搜尋商品,並依分類列出商品(預設依單價排序)
  • 依商品 id 或 EAN/GTIN 條碼查詢商品與各零售商價格
  • 比較某商品的目前零售商價格與競品商品資料
  • 比較小型購物籃在各零售商之間的價格
  • 瀏覽分類樹、已知零售商與資料集整體統計
  • 在可用時取得含價格歷史的產品詳細資料
適用情境
適合需要助理回答希臘超市價格問題的情境:尋找商品、查詢條碼對應價格,或比較一份簡短購物清單在各零售商的價格。
執行需求
以 npm 套件在本機執行(npx posokanei-mcp),需要 Node.js,並在 MCP 用戶端中設定。不需帳號或 API 金鑰。選用環境變數 POSOKANEI_API_BASE、POSOKANEI_CACHE_TTL_MS、POSOKANEI_MIN_INTERVAL_MS 與 POSOKANEI_TIMEOUT_MS 可調整介面位址、快取、請求間隔與逾時。需要能連線至 PosoKanei API 的網路。
安裝前請注意
雖為唯讀,但呼叫的是 PosoKanei 公開且未文件化的介面,可能隨時失效,應節制請求頻率。與 PosoKanei、gov.gr 或任何希臘公共機關皆無關聯。商品查詢內容會傳送給該第三方 API。

安裝

在 SourceWeft 中

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

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

其他 MCP 客戶端

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

README

posokanei-mcp

Unofficial read-only MCP server for supermarket product and price data from PosoKanei.

This server lets MCP-compatible clients ask questions such as:

  • Search for supermarket products by name.
  • Look up a product by barcode.
  • Compare current retailer prices for a product.
  • Compare a small shopping basket across retailers.
  • Browse product categories and retailers.

Status

Early open-source version. The implementation uses public, undocumented endpoints used by the PosoKanei web app. Keep requests modest and cache-friendly.

This project is not affiliated with, endorsed by, or operated by PosoKanei, gov.gr, or any Greek public authority.

Installation

Add it to your MCP client configuration:

json
{  "mcpServers": {    "posokanei": {      "command": "npx",      "args": ["-y", "posokanei-mcp"]    }  }}

For local development:

json
{  "mcpServers": {    "posokanei": {      "command": "node",      "args": ["/absolute/path/to/posokanei-mcp/dist/index.js"]    }  }}

Build first:

sh
npm installnpm run build

Tools

ToolPurpose
search_productsSearch products by text.
get_productGet details and retailer prices for a product id.
lookup_barcodeFind product prices by EAN/GTIN barcode.
list_products_by_categoryList category products, sorted by unit price by default.
list_categoriesReturn a simplified category tree.
list_retailersList known retailers.
get_price_historyFetch product detail with history when available.
compare_competitorsFetch comparable/competitor product data when available.
compare_basketCompare a small basket across retailers.
get_statsReturn high-level dataset stats.

Configuration

Optional environment variables:

VariableDefaultPurpose
POSOKANEI_API_BASEhttps://api.posokanei.gov.grAPI base URL.
POSOKANEI_CACHE_TTL_MS300000In-memory cache TTL.
POSOKANEI_MIN_INTERVAL_MS250Minimum delay between outbound API requests.
POSOKANEI_TIMEOUT_MS15000Request timeout.

Development

sh
npm installnpm run typechecknpm test

The test suite mocks the PosoKanei API. It should not require live network access.

License

MIT

來源:README.md,提交 444be79

工具

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

版本歷史

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

評分

已滿足適用檢查項的 50%

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

  • 近 30 天內可連通25 分

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

  • 已宣告認證方式10 分

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

  • 已列出工具15 分

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

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