Tibber MCP 服务器

这是一个用于挪威电力供应商 Tibber 的 模型上下文协议 (MCP) 服务器。

你可以在本地运行 MCP 服务器，并通过不同的主机访问它，例如 Claude Desktop 或 Roo Code。

更多详情，请查看我的博客文章： 构建 Tibber MCP 服务器：将你的 AI 代理连接到能源消耗数据

概述

Tibber MCP 服务器为 AI 代理提供了一种便捷的方式来与 Tibber API 交互，并查询诸如当前能源价格和你的能源消耗数据等信息。

示例查询

连接到 MCP 服务器后，你可以提出如下问题：

• "分析我的用电数据，并以易于阅读的格式呈现通常的用电高峰时段和任何其他有趣的模式。"
• "昨天我什么时候用电最多？"
• "昨天早上 7 点我消耗了多少电？"
• "当前能源价格是多少？"
• "列出明天最便宜的 3 个小时。"
• "明天的能源价格是更高还是更低？"

演示视频

架构

要求

• Python 3.12
• Tibber API 令牌 (你可以从 Tibber 开发者门户 获取)

安装

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 Code 的 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 inspector

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

可用工具

服务器公开了以下 LLM 可以使用的工具：

1. get_consumption_data(): 获取过去 30 天的每小时消耗数据，例如时间段、总成本、基本能源成本和消耗的千瓦时
2. get_price_and_home_info(): 获取价格信息（当前、今天和明天）和家庭信息（所有者、地址、订阅...）

许可证

MIT 许可证

致谢

• 此工具使用 Anthropic 的 MCP 框架
• 使用 FastMCP 进行服务器实现
• Tibber 集成基于 pyTibber 库