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