akahu-mcp

Akahu（ニュージーランドのオープンバンキング）データをClaudeのようなLLMエージェントに公開するMCPサーバーです。エージェントが銀行口座の一覧表示、投資保有資産の確認、分析用の取引履歴取得を行えるようにします。

ローカルのSQLiteキャッシュ（cache.db）が過去約90日分の取引履歴をディスク上に保持し、段階的に更新します。キャッシュのTTLは、Akahu Personalのアップストリーム更新頻度（1日1回）に合わせて24時間に設定されています。エージェントは任意のツールで force=True を渡すことで、これをバイパスできます。

ツール

list_accounts(force=False) — 残高を含む銀行口座/預金口座。Sharesightは除外されます。
get_share_holdings(force=False) — Sharesightポートフォリオ：合計価値、内訳（リターン/資本/通貨/配当）、および保有銘柄ごとの行。
list_transactions(account, start=None, end=None, limit=100, force=False) — ローカルキャッシュから特定の口座の取引履歴を取得します。キャッシュが24時間以上経過している場合は、先にAkahuから更新します。account はIDまたは名前の曖昧な部分一致で指定します。

セットアップ

まだインストールしていない場合は、uv をインストールしてください。
Akahu Personal App をセットアップします。これは、自分のAkahuアカウントに対して作成する無料のシングルユーザーアプリです。app_token（個人アプリのID）と、自分自身の user_token が取得できます。
プロジェクトのルートに .env ファイルを作成します：
```
AKAHU_USER_TOKEN=user_token_xxx
AKAHU_APP_TOKEN=app_token_xxx
```
uv sync を実行して依存関係をインストールします。
動作確認：uv run python -m akahu_mcp.sync — 口座が表示され、最初の口座の取引履歴が取得されるはずです。

MCPホストへの組み込み

Claude Code

claude mcp add akahu --scope user -- uv --directory /absolute/path/to/akahu-mcp run akahu-mcp

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または各プラットフォームの対応するファイルに追加します：

{
  "mcpServers": {
    "akahu": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/akahu-mcp", "run", "akahu-mcp"]
    }
  }
}

ホストがPATH上で uv を見つけられない場合は、`"uv