tako-mcp
An MCP server for the Octopus Energy Japan GraphQL API that allows users to retrieve electricity consumption, cost estimates, and contract details. It enables 30-minute interval usage analysis and postal code area searches while ensuring privacy by excluding personal address information.
README
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
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.