Posokanei MCP Server

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

After the package is published to npm:

{
  "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

Configuration

Optional environment variables:

Development

npm install
npm run typecheck
npm test

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

Publishing

1. Commit and push the repository to GitHub.
2. Publish the npm package.
3. Publish server.json with mcp-publisher.

package.json already declares mcpName, and server.json is configured for io.github.charistas/posokanei-mcp. The MCP Registry hosts metadata, not package artifacts. Users still install the npm package.

License

MIT