Tako MCP

🚀 tako-mcp

這是 Octopus Energy Japan GraphQL API 的 MCP 服務器。藉助 MCP 工具，你可以獲取電力使用量、成本估算、合同信息、費率計劃等內容。該服務器可用於 Claude 等大語言模型（LLM）對能源使用情況的分析。

🚀 快速開始

本項目默認以 stdio 傳輸模式運行，你可以使用以下命令啟動：

OCTOPUS_EMAIL=you@example.com OCTOPUS_PASSWORD=your-password OCTOPUS_ACCOUNT_NUMBER=A-AAAA1111 npx tako-mcp

若要切換到 Streamable HTTP 傳輸模式，可添加 --http 標誌：

OCTOPUS_EMAIL=you@example.com OCTOPUS_PASSWORD=your-password OCTOPUS_ACCOUNT_NUMBER=A-AAAA1111 npx tako-mcp --http

若未指定 PORT 環境變量，系統將自動選擇一個空閒端口。

✨ 主要特性

• 可獲取 30 分鐘為單位的電力消耗量及成本估算。
• 能獲取賬戶和合同信息（包括產品和基本費用）。
• 支持通過郵政編碼搜索區域信息。
• 注重隱私保護：個人地址等信息不會出現在工具響應中。

📦 安裝指南

必要條件

• Node.js 22+
• Octopus Energy Japan 賬戶（包含電子郵件地址和密碼）

💻 使用示例

環境變量說明

MCP 工具列表

客戶端配置

Claude Desktop / Claude Code

{
  "mcpServers": {
    "tako-mcp": {
      "command": "npx",
      "args": ["-y", "tako-mcp"],
      "env": {
        "OCTOPUS_EMAIL": "you@example.com",
        "OCTOPUS_PASSWORD": "your-password",
        "OCTOPUS_ACCOUNT_NUMBER": "A-AAAA1111"
      }
    }
  }
}

HTTP 模式

{
  "mcpServers": {
    "tako-mcp": {
      "type": "http",
      "url": "http://localhost:<port>/mcp"
    }
  }
}

📚 詳細文檔

開發命令

npm install
npm run dev        # 使用 tsx 啟動
npm run build      # 使用 tsup 進行打包
npm run typecheck  # 進行類型檢查
npm run check      # 進行 Lint 和格式化（使用 Biome）

📄 許可證

本項目採用 MIT 許可證。