Tako MCP

🚀 tako - mcp

Octopus Energy JapanのGraphQL APIのMCPサーバーです。電力の使用量やコスト見積、契約情報、料金プランなどをMCPツール経由で取得することができ、ClaudeなどのLLMを用いたエネルギー使用状況の分析に役立ちます。

🚀 クイックスタート

tako - mcpを使うことで、Octopus Energy JapanのGraphQL APIを通じて様々なエネルギー関連情報を取得できます。必要な環境を準備し、以下の手順に沿って利用しましょう。

✨ 主な機能

• 30分単位の電力消費量とコスト見積を取得できます。
• アカウントや契約情報（プロダクトや基本料金を含む）を取得できます。
• 郵便番号からエリア情報を検索できます。
• 住所などの個人情報はツールのレスポンスから除外され、プライバシーが重視されています。

📦 インストール

必要条件

• Node.js 22+
• Octopus Energy Japanのアカウント（メールアドレスとパスワード）

💻 使用例

基本的な使用法

デフォルトではstdioトランスポートで動作します。

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

高度な使用法

HTTPモード

--httpフラグを使ってStreamable HTTPトランスポートに切り替えることができます。

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

PORTを指定しない場合、空きポートが自動的に選択されます。

環境変数

📚 ドキュメント

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