posokanei-mcp

Name: posokanei-mcp
Author: charistas

本地服务

github.com/charistas商业与营销63 周前更新

代码仓库

关于 posokanei-mcp

posokanei-mcp 是一个非官方、只读的 MCP 服务，提供希腊超市商品与价格数据。MCP 客户端可用它搜索商品、查看零售商报价并比较购物篮。

主要功能

01按名称或条码搜索商品
02查看商品详情和零售商价格
03浏览品类与零售商
04查询价格历史和可比商品
05比较不同零售商的少量购物篮

适用场景

01按名称或条码查找商品
02比较不同零售商的当前价格
03查看商品可用的价格历史
04估算不同零售商的购物篮费用

MCP 相关

通过工具向 MCP 客户端提供 PosoKanei 的商品、价格、品类、零售商、历史及比较数据。服务为只读。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "charistas-posokanei": {
      "command": "npx",
      "args": [
        "-y",
        "posokanei-mcp"
      ],
      "env": {
        "POSOKANEI_API_BASE": "<POSOKANEI_API_BASE>",
        "POSOKANEI_CACHE_TTL_MS": "<POSOKANEI_CACHE_TTL_MS>",
        "POSOKANEI_MIN_INTERVAL_MS": "<POSOKANEI_MIN_INTERVAL_MS>",
        "POSOKANEI_TIMEOUT_MS": "<POSOKANEI_TIMEOUT_MS>"
      }
    }
  }
}

启动命令npx -y posokanei-mcp

需要配置的环境变量

POSOKANEI_API_BASEOptional PosoKanei API base URL override.

POSOKANEI_CACHE_TTL_MSOptional cache TTL in milliseconds.

POSOKANEI_MIN_INTERVAL_MSOptional minimum delay between outbound PosoKanei API requests.

POSOKANEI_TIMEOUT_MSOptional outbound request timeout in milliseconds.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmposokanei-mcp0.1.1stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
page	integer	否	结果页。
query	string	是	商品搜索文本，例如 'γάλα' 或 'feta'。
sortBy	enum	否	排序字段。name \| price \| unit_price
pageSize	integer	否	每页结果数。上限为 50。
sortOrder	enum	否	排序顺序。asc \| desc

详细介绍

posokanei-mcp

用于查询来自 PosoKanei 的超市商品和价格数据的非官方只读 MCP 服务。

此服务允许兼容 MCP 的客户端提出以下问题：

按名称搜索超市商品。
按条形码查询商品。
比较商品在当前各零售商处的价格。
比较各零售商处的一小篮商品。
浏览商品类别和零售商。

状态

早期的开源版本。此实现使用 PosoKanei 网页应用所用的公开但未编写文档的接口。请适度发送请求，并尽量利用缓存。

此项目与 PosoKanei、gov.gr 或任何希腊公共机构均无关联，也未获得其认可或由其运营。

安装

将其添加到 MCP 客户端配置中：

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

本地开发：

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

首先进行构建：

npm install
npm run build

工具

工具	用途
`search_products`	按文本搜索商品。
`get_product`	获取指定商品 ID 的详情和零售商价格。
`lookup_barcode`	按 EAN/GTIN 条形码查找商品价格。
`list_products_by_category`	列出类别商品，默认按单位价格排序。
`list_categories`	返回简化的类别树。
`list_retailers`	列出已知零售商。
`get_price_history`	获取商品详情及可用的价格历史。
`compare_competitors`	获取可比较商品／竞品数据（如有）。
`compare_basket`	比较各零售商处的一小篮商品。
`get_stats`	返回数据集的高级统计信息。

配置

可选环境变量：

变量	默认值	用途
`POSOKANEI_API_BASE`	`https://api.posokanei.gov.gr`	API 基础 URL。
`POSOKANEI_CACHE_TTL_MS`	`300000`	内存缓存 TTL。
`POSOKANEI_MIN_INTERVAL_MS`	`250`	外发 API 请求之间的最短间隔。
`POSOKANEI_TIMEOUT_MS`	`15000`	请求超时时间。