Skip to main content
Glama
enesjakozh
linkcd

Tibber MCP

by linkcd
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Tibber MCP サーバー

これは、ノルウェーの電力供給業者Tibberのモデル コンテキスト プロトコル (MCP)サーバーです。

MCP サーバーをローカルで実行し、Claude Desktop やRoo Codeなどのさまざまなホスト経由でアクセスできます。

詳細については、私のブログ投稿をご覧ください。
Tibber MCPサーバーの構築：AIエージェントをエネルギー消費データに接続する

概要

Tibber MCP サーバーは、AI エージェントにTibber APIと対話し、現在のエネルギー価格やエネルギー消費データなどの情報を照会するための便利な方法を提供します。

Related MCP server: Tigo Energy MCP Server

クエリの例

MCP サーバーに接続すると、次のような質問をすることができます。

  • 「電力消費データを分析し、通常のピーク時間やその他の興味深いパターンを読みやすい形式で提示します。」

  • 「昨日、最も電力を使ったのはいつですか？」

  • 「昨日の午前7時にどれくらいの電力を消費したか？」

  • 「現在のエネルギー価格はいくらですか？」

  • 「明日の最も安い 3 つの時間をリストします。」

  • 「明日のエネルギー価格は上がるのか、下がるのか？」

デモビデオ

Tibber MCP デモ

建築

建築

要件

インストール

  1. uvをインストールします:

    # On macOS and Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
    # On Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

  2. このリポジトリをクローンします:

    git clone https://github.com/linkcd/tibber-mcp.git
cd tibber-mcp

  3. Python 仮想環境をセットアップし、依存関係をインストールします。

    uv venv --python 3.12 && source .venv/bin/activate && uv pip install --requirement pyproject.toml

ホスト構成

Claude DesktopまたはVSのRoo Code

{
   "mcpServers":{
      "tibber":{
         "command":"uv",
         "args":[
            "--directory",
            "[PATH-TO-ROOT-OF-THE-CLONED-TIBBER-MCP-FOLDER]",
            "run",
            "server.py"
         ],
         "env":{
            "TIBBER_API_TOKEN":"[YOUR-TIBBER-TOKEN]"
         }
      }
   }
}

重要： [YOUR-TIBBER-TOKEN]実際のトークンに置き換えてください。実際の認証情報をバージョン管理にコミットしないでください。

MCP サーバーをローカルでデバッグおよびテストする

サーバーをローカルで実行し、 MCPインスペクターを実行します。

npx @modelcontextprotocol/inspector -e TIBBER_API_TOKEN=[YOUR-TIBBER-TOKEN] python server.py

利用可能なツール

サーバーは、LLM が使用できる次のツールを公開します。

  1. get_consumption_data() : 期間、総コスト、基本エネルギーコスト、消費kwhなど、過去30日間の時間別消費データを取得します。

  2. get_price_and_home_info() : 価格情報 (現在、今日、明日) と住宅情報 (所有者、住所、サブスクリプションなど) を取得します。

ライセンス

MITライセンス

謝辞

  • このツールはAnthropicのMCPフレームワークを使用しています

  • サーバー実装用にFastMCPで構築

  • TibberインジェラトインはpyTibberライブラリに基づいています

Available Tools

2 tools
get_consumption_dataB

Get the hourly consumption data for the last 30 days, such as time period, total cost, base energy cost, and consumpted kwh.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It describes the data returned but doesn't cover critical aspects like whether this is a read-only operation, potential rate limits, authentication needs, error conditions, or response format. For a data retrieval tool with zero annotation coverage, this is a significant gap in transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence that front-loads the key action and scope. It lists data fields concisely without redundancy. However, it could be slightly more structured by separating the action from the data details, but overall it's appropriately sized with minimal waste.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (data retrieval with no parameters) and lack of annotations and output schema, the description is incomplete. It covers what data is fetched but omits behavioral traits, usage context, and output details. For a tool with no structured support, the description should provide more comprehensive guidance to aid the agent effectively.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 0 parameters with 100% coverage, so the schema fully documents the lack of inputs. The description doesn't need to add parameter details, as there are none to explain. It implies the tool operates without user-provided parameters, which aligns with the schema. Baseline is 4 for zero parameters, as the description doesn't contradict or add unnecessary info.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Get') and resource ('hourly consumption data'), specifying the time range ('last 30 days') and data fields (e.g., time period, total cost). It distinguishes from the sibling tool 'get_price_and_home_info' by focusing on consumption rather than price/home info, though it doesn't explicitly name the sibling. The purpose is specific but lacks explicit sibling differentiation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives, such as the sibling tool 'get_price_and_home_info'. It mentions the data scope but doesn't explain use cases, prerequisites, or exclusions. This leaves the agent without clear context for tool selection.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_price_and_home_infoB

Get the infomation of: 1. current price, with price break down, price level, and currency 2. hourly price and price level of today 3. hourly price and price level of tomorrow 4. home address info, timezone etc the currency is applying to all prices

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden for behavioral disclosure. It describes what data is returned but doesn't mention whether this is a read-only operation, potential rate limits, authentication needs, or error conditions. It lacks critical behavioral context for an agent.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is structured as a bulleted list which helps organization, but contains minor spelling errors ('infomation') and could be more front-loaded. The information is reasonably concise but not optimally polished.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with no parameters and no output schema, the description adequately explains what data is returned (price breakdowns, home info). However, without annotations or output schema, it should ideally provide more behavioral context about the operation's characteristics and return format.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has 0 parameters with 100% schema description coverage, so the schema already fully documents the empty parameter set. The description appropriately doesn't discuss parameters, maintaining focus on what the tool returns rather than what it accepts.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool retrieves price information (current, hourly today/tomorrow) and home address/timezone data. It specifies the verb 'Get' and resources (price data, home info), though it doesn't explicitly differentiate from the sibling tool 'get_consumption_data'.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus the sibling 'get_consumption_data'. The description lists what data is retrieved but doesn't specify use cases, prerequisites, or alternatives.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 2 tool updates
    • First observedget_consumption_data
    • First observedget_price_and_home_info
Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

B3.3/5.0

Scored across 2 tools

Disambiguation5/5

The two tools have clearly distinct purposes: one focuses on consumption data (historical usage and costs), while the other focuses on price information and home details (current, forecasted pricing and location/timezone). There is no overlap in functionality, making it easy for an agent to select the correct tool based on the query.

Naming Consistency5/5

Both tools follow a consistent verb_noun pattern with 'get_' prefix and descriptive names (get_consumption_data and get_price_and_home_info). The naming is predictable and readable, adhering to a clear convention throughout the set.

Tool Count3/5

With only 2 tools, the server feels thin for a domain like energy/utility management, which typically involves more operations such as setting preferences, controlling devices, or accessing billing history. While the tools cover key data retrieval aspects, the count is borderline low for comprehensive agent interaction.

Completeness3/5

The tools provide good read-only coverage for consumption and pricing data, but there are notable gaps: no update/delete operations, no ability to manage home settings or devices, and no support for actions like adjusting energy usage or handling billing. This limits the server to data retrieval only, which may cause agent failures in broader utility management tasks.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Tigo Energy MCP Server

    matt-dreyer
    A
    license
    Not graded
    quality
    D
    maintenance
    A Model Context Protocol (MCP) server that provides comprehensive access to Tigo Energy solar system data and analytics. It enables AI assistants to interact with your Tigo solar monitoring system to retrieve production data, performance metrics, system health information, and maintenance insights.
    MIT

  • emoncms-mcp-server

    guibrazlima
    F
    license
    Not graded
    quality
    D
    maintenance
    MCP server for EmonCMS energy monitoring API, enabling AI assistants to query energy feeds, inputs, and historical data.
    1
    -

  • Monta MCP Server

    nickknissen
    F
    license
    A
    quality
    D
    maintenance
    MCP server that enables LLMs to interact with Monta's EV charging platform for managing charge points, charging sessions, and wallet operations.
    7
    -

Appeared in Searches