English Français العربية

io.github.charistas/posokanei-mcp

Registre officiel E-commerce

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package posokanei-mcp
Claude Code 
claude mcp add posokanei-mcp -e 'POSOKANEI_API_BASE=<POSOKANEI_API_BASE>' -e 'POSOKANEI_CACHE_TTL_MS=<POSOKANEI_CACHE_TTL_MS>' -e 'POSOKANEI_MIN_INTERVAL_MS=<POSOKANEI_MIN_INTERVAL_MS>' -e 'POSOKANEI_TIMEOUT_MS=<POSOKANEI_TIMEOUT_MS>' -- npx -y posokanei-mcp@0.1.1
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "posokanei-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "posokanei-mcp@0.1.1"
            ],
            "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>"
            }
        }
    }
}

Variables d'environnement

  • POSOKANEI_API_BASE Optional PosoKanei API base URL override.
  • POSOKANEI_CACHE_TTL_MS Optional cache TTL in milliseconds.
  • POSOKANEI_MIN_INTERVAL_MS Optional minimum delay between outbound PosoKanei API requests.
  • POSOKANEI_TIMEOUT_MS Optional outbound request timeout in milliseconds.

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. posokanei-mcp
  2. Status
  3. Installation
  4. Tools
  5. Configuration
  6. Development
  7. License

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:

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

For local development:

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

Build first:

npm install
npm 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

npm install
npm run typecheck
npm test

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

License

MIT

Questions fréquentes

Qu'est-ce que io.github.charistas/posokanei-mcp ?

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

Comment installer io.github.charistas/posokanei-mcp ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add posokanei-mcp -e 'POSOKANEI_API_BASE=<POSOKANEI_API_BASE>' -e 'POSOKANEI_CACHE_TTL_MS=<POSOKANEI_CACHE_TTL_MS>' -e 'POSOKANEI_MIN_INTERVAL_MS=<POSOKANEI_MIN_INTERVAL_MS>' -e 'POSOKANEI_TIMEOUT_MS=<POSOKANEI_TIMEOUT_MS>' -- npx -y posokanei-mcp@0.1.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.charistas/posokanei-mcp ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

io.github.charistas/posokanei-mcp est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.charistas/posokanei-mcp ?

Il est publié par charistas. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.