Skip to main content
Glama
deenesjakoruzh
Paszymaja

elicznik-mcp

by Paszymaja
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

elicznik-tauron

Tauron eLicznik ポータル用の非公式 CLI および MCP サーバーです (https://elicznik.tauron-dystrybucja.pl)。コマンドラインからエネルギー消費量、発電量、メーター指示値を取得したり、Model Context Protocol を介して AI エージェントに公開したりできます。

Tauron とは提携していません。ポータルが使用しているのと同じ内部 Web API を使用します。

特徴

  • ログイン — Keycloak フォーム POST による（ブラウザ不要）。セッション Cookie はディスクにキャッシュされ、自動的に更新されます。

  • CLI（elicznik）— メーターの一覧表示、エネルギー情報の取得、指示値の登録ができます。

  • MCP サーバー（elicznik-mcp、stdio）— 同じデータをツールとして MCP クライアント（OpenCode や Claude など）に公開します。

利用可能なデータ:

データ

粒度

消費 / 発電 / ネット

時間、日、月、年

時間ごとの料金帯（zone）

時間

メーターの累積指示値

日

Related MCP server: Enapter MCP Server

必要環境

Python 3.10+ と uv が必要です。

セットアップ

uv sync --extra mcp
cp .env.example .env   # then fill in your credentials

.env:

ELICZNIK_USERNAME=your-login-or-email
ELICZNIK_PASSWORD=your-password
# Optional: pick a specific metering point if you have more than one
# ELICZNIK_SITE=5842033_61898031_5842033

セッション Cookie は elicznik_session.json にキャッシュされるため（gitignore 済み）、ログインは一度だけです。セッションの有効期限が切れると、クライアントは自動的に再認証します。

CLI

# List metering points
uv run elicznik meters

# Hourly consumption for a day (defaults: today, metric=consumption, resolution=hour)
uv run elicznik energy --metric consumption --from 2026-08-24 --to 2026-08-24

# Daily / monthly / yearly totals
uv run elicznik energy --metric consumption --resolution day   --from 2026-08-01 --to 2026-08-26
uv run elicznik energy --metric consumption --resolution month --from 2026-01-01 --to 2026-08-26
uv run elicznik energy --metric generation  --resolution year  --from 2026-01-01 --to 2026-08-26

# Output formats: table (default), csv, json
uv run elicznik energy --metric consumption --resolution day --from 2026-08-01 --to 2026-08-26 --format json

# Cumulative meter register readings (billing readings)
uv run elicznik readings --from 2026-08-01 --to 2026-08-26
uv run elicznik readings --from 2026-08-01 --to 2026-08-26 --generation   # returned energy

メトリクス: consumption、generation、net_consumption、net_generation。

MCP サーバー

サーバーは次の4つのツールを公開します:

  • list_meters — 計量地点の一覧

  • get_energy(metric, start_date, end_date, resolution) — 1つのメトリクスを、合計値と地点ごとの値とともに取得

  • get_readings(start_date, end_date, resolution) — 地点ごとの全4メトリクス

  • get_meter_readings(start_date, end_date, generation) — 累積メーター指示値の取得

OpenCode

~/.config/opencode/opencode.json に追加:

{
  "mcp": {
    "elicznik": {
      "type": "local",
      "command": ["uv", "run", "--directory", "/home/paszymaja/github_projects/elicznik-tauron", "elicznik-mcp"],
      "enabled": true
    }
  }
}

Claude for Desktop

claude_desktop_config.json に追加:

{
  "mcpServers": {
    "elicznik": {
      "command": "uv",
      "args": ["--directory", "/ABSOLUTE/PATH/TO/elicznik-tauron", "run", "elicznik-mcp"]
    }
  }
}

サーバーは、プロジェクトディレクトリ内の .env（または ELICZNIK_USERNAME / ELICZNIK_PASSWORD 環境変数）から認証情報を読み取ります。

Docker

コンテナイメージは GitHub Container Registry（ghcr.io/paszymaja/elicznik-tauron）に公開されています。認証情報は ELICZNIK_USERNAME / ELICZNIK_PASSWORD 環境変数から読み取られます（.env は不要）。セッションキャッシュは /tmp に書き込まれます（一時的）。

# CLI
docker run --rm \
  -e ELICZNIK_USERNAME -e ELICZNIK_PASSWORD \
  ghcr.io/paszymaja/elicznik-tauron:latest meters

docker run --rm \
  -e ELICZNIK_USERNAME -e ELICZNIK_PASSWORD \
  ghcr.io/paszymaja/elicznik-tauron:latest \
  energy --metric consumption --resolution day --from 2026-08-01 --to 2026-08-26

# MCP server over stdio (note the -i flag for stdin)
docker run -i --rm \
  -e ELICZNIK_USERNAME -e ELICZNIK_PASSWORD \
  ghcr.io/paszymaja/elicznik-tauron:latest mcp

イメージをローカルでビルドするには:

docker build -t elicznik-tauron .

開発

uv sync --extra mcp
uv run pytest

注記

  • ポータルの TLS サーバーは、Python のデフォルト OpenSSL ポリシーが拒否する暗号スイートをネゴシエートします。クライアントは回避策として DEFAULT@SECLEVEL=1 アダプターをマウントします（session.py を参照）。

  • 時間単位の CSV タイムスタンプは 終了 時刻を表します。クライアントはこれをチャート API の規則に合わせて、時間の開始時刻を示すタイムスタンプに正規化します。

  • タイムスタンプはローカルタイム（Europe/Warsaw）で、タイムゾーンオフセットは含まれません。

ライセンス

MIT

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Nikola TEST MCP Server

    Traia-IO
    F
    license
    Not graded
    quality
    D
    maintenance
    Provides AI agents and LLMs access to the Nikola TEST MCP API through standardized MCP tools for seamless integration and interaction.
    -

  • euenergy-mcp

    adambenhassen
    F
    license
    Not graded
    quality
    C
    maintenance
    A read-only MCP server that exposes European day-ahead electricity prices for ~41 bidding zones via tools like hourly prices, cheapest hours, current price, and cross-zone summary, enabling AI agents to query energy market data.
    1
    -