arrow2nd

tako-mcp

Community arrow2nd
Updated

tako-mcp

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

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

特徴

  • 30分単位の電力消費量・コスト見積の取得
  • アカウント・契約情報の取得(プロダクト・基本料金含む)
  • 郵便番号からのエリア情報検索
  • プライバシー重視: 住所等の個人情報はツールレスポンスから除外

必要条件

  • Node.js 22+
  • Octopus Energy Japan のアカウント(メールアドレス・パスワード)

使い方

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

[email protected] OCTOPUS_PASSWORD=your-password OCTOPUS_ACCOUNT_NUMBER=A-AAAA1111 npx tako-mcp

HTTP モード

--http フラグで Streamable HTTP トランスポートに切り替えられます。

[email protected] 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": "[email protected]",
        "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

MCP Server · Populars

MCP Server · New