返回 MCP 目录
public公开dns本地运行

tibber-mcp

这是一个为挪威电力供应商Tibber构建的MCP服务器项目,允许AI代理通过Model Context Protocol访问Tibber API,查询能源价格和用电量数据。项目提供本地运行方案,支持通过Claude Desktop等客户端连接。

article

README

🚀 Tibber MCP 服务器

Tibber MCP 服务器是专为 Tibber(挪威电力供应商)打造的 Model Context Protocol (MCP) 服务器。它能让你在本地运行 MCP 服务器,并通过不同主机(如 Claude Desktop 或 Roo Code)进行访问。

🚀 快速开始

Tibber MCP 服务器为 AI 代理提供了一种便捷的方式来交互 Tibber API 并查询信息,例如当前能源价格和能源消耗数据。你可以在本地运行该服务器,然后通过不同主机与之连接并提出相关查询。

✨ 主要特性

  • 为 AI 代理提供便捷途径,可交互 Tibber API 并查询能源相关信息。
  • 支持多种类型的查询,如分析电力消耗数据、查询特定时间的电力消耗、获取当前能源价格等。
  • 提供演示视频,方便用户快速了解其使用方式。

📦 安装指南

安装要求

安装步骤

  1. 安装 uv

    # 在 macOS 和 Linux 上
    curl -LsSf https://astral.sh/uv/install.sh | sh
    
    # 在 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
    

💻 使用示例

基础用法

一旦连接到 MCP 服务器,你可以提出以下问题:

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

📚 详细文档

演示视频

你可以通过以下演示视频快速了解 Tibber MCP 服务器的使用方式: Tibber MCP 演示

架构

该服务器的架构如下: 架构

主机配置

在 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

暴露的工具

  • tibber

更多详细信息,请参阅我的博客文章:
构建 Tibber MCP 服务器:将 AI 代理连接到能源消耗数据

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端