Skip to main content
Glama
Sign In
tako-mcp

tako-mcp

by arrow2nd
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

tako-mcp

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

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

特徴

  • 30分単位の電力消費量・コスト見積の取得

  • アカウント・契約情報の取得（プロダクト・基本料金含む）

  • 郵便番号からのエリア情報検索

  • プライバシー重視: 住所等の個人情報はツールレスポンスから除外

Related MCP server: edinet-mcp

必要条件

  • 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

郵便番号からエリア情報を検索

不要

MCP リソース一覧

URI

説明

認証

octopus://consumption/today

当日（JST）の30分単位の電力消費量・コスト見積（合計サマリ付き）

必要

クライアント設定

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

Available Tools

3 tools
get_account_infoA

Get account information including contract status, electricity supply points, active agreements, product details and standing charges. Address is excluded for privacy.

Inputs: no named parameters.

get_electricity_consumptionA

Get half-hourly electricity consumption data with cost estimates. Returns 30-minute interval readings for the specified period.

Inputs: period_to (required), period_from (required).

get_postal_areasA

Look up area information by Japanese postcode. Returns prefecture, city, and area. No authentication required.

Inputs: postcode (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.8/5.0

    Scored across 3 tools

    Disambiguation5/5

    All three tools have clearly distinct purposes: account info, electricity consumption, and postal area lookup. No overlap exists between them.

    Naming Consistency5/5

    All tools follow a consistent 'get_' prefix with a noun, forming a uniform verb_noun pattern.

    Tool Count3/5

    3 tools is quite low for a server that seems to cover energy management plus an unrelated postal lookup. The scope feels thin.

    Completeness2/5

    The server lacks obvious tools for billing, agreement management, or other energy-related operations. The inclusion of a Japanese postal area tool suggests an inconsistent or incomplete domain coverage.

    Resources

    Related MCP Connectors

    Related MCP Servers

    • GitHub GraphQL API MCP

      wanzunz
      F
      license
      B
      quality
      D
      maintenance
      A server that allows you to explore the GitHub GraphQL schema and execute GraphQL queries through MCP client tools, enabling efficient data retrieval from GitHub with reduced token consumption.
      4
      4
      -

    • edinet-mcp

      hwibalyu
      F
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that interfaces with the Japanese EDINET API v2 to search, download, and extract text from financial disclosure documents. It enables users to browse disclosure lists, retrieve document originals, and perform natural language searches for specific financial filings.
      -

    • hokan MCP Server

      SHINONFT
      F
      license
      Not graded
      quality
      D
      maintenance
      An unofficial MCP server that integrates with the hokan Insurance CRM API v2 to manage customer data, schedules, and tasks. It also features specialized tools for Japanese insurance law compliance, including intent confirmation and regulatory check generation.
      -

    • mcp-entso-e

      pipeworx-io
      A
      license
      Not graded
      quality
      B
      maintenance
      MCP server for querying ENTSO-E Transparency Platform data including actual load, generation per type, cross-border flows, and installed capacity.
      155 npm
      MIT