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