tako-mcp

Octopus Energy Japan GraphQL API の MCP サーバー。

電力の使用量・コスト見積、契約情報、料金プランなどを MCP ツール経由で取得できます。Claude をはじめとする LLM でのエネルギー使用状況の分析に活用できます。

特徴

• 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 未指定時は空きポートが自動選択されます。

環境変数

変数名	必須	説明
OCTOPUS_EMAIL	Yes	Octopus Energy Japan のログインメールアドレス
OCTOPUS_PASSWORD	Yes	Octopus Energy Japan のログインパスワード
OCTOPUS_ACCOUNT_NUMBER	Yes	アカウント番号（例: A-AAAA1111）
PORT	No	HTTP モード時のポート番号（デフォルト: 自動選択）

MCP ツール一覧

ツール	説明	認証
get_account_info	アカウント・契約情報（プロダクト・基本料金含む、住所は除外）	必要
get_electricity_consumption	30分単位の電力消費量・コスト見積	必要
get_postal_areas	郵便番号からエリア情報を検索	不要

クライアント設定

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