akahu-mcp

Сервер MCP, предоставляющий Akahu (открытый банкинг в Новой Зеландии) данные для LLM-агентов, таких как Claude. Позволяет агенту просматривать ваши банковские счета, проверять инвестиционные портфели и получать транзакции для анализа.

Локальный кэш SQLite (cache.db) хранит транзакции примерно за последние 90 дней на диске и обновляется инкрементально. Время жизни кэша (TTL) составляет 24 часа, что соответствует частоте обновления данных в Akahu Personal (раз в сутки); агенты могут передать force=True в любой инструмент, чтобы обойти это ограничение.

Инструменты

• list_accounts(force=False) — банковские/депозитные счета с балансами. Sharesight исключен.

• get_share_holdings(force=False) — портфель Sharesight: общая стоимость, детализация (доходность / капитал / валюта / дивиденды) и строки по каждому активу.

• list_transactions(account, start=None, end=None, limit=100, force=False) — транзакции по одному счету из локального кэша, с предварительным обновлением из Akahu, если кэш старше 24 часов. account сопоставляется по ID или нечеткому совпадению подстроки имени.

Настройка

1. Установите uv, если у вас его еще нет.

2. Настройте Akahu Personal App — это бесплатные приложения для одного пользователя, которые вы создаете для своей учетной записи Akahu. Вы получите app_token (ID личного приложения) и user_token для себя.

3. Создайте файл .env в корне проекта:

   AKAHU_USER_TOKEN=user_token_xxx
   AKAHU_APP_TOKEN=app_token_xxx

4. uv sync для установки зависимостей.

5. Проверка работоспособности: 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"]
    }
  }
}

Если ваш хост не может найти uv в PATH, замените "uv" на абсолютный путь, полученный командой which uv.

Примечания

• Создано и протестировано с использованием Akahu Personal Apps, которые обновляют данные на стороне сервера только раз в день — отсюда и TTL кэша в 24 часа. Те же конечные точки существуют в коммерческих планах, но там может иметь смысл сократить TTL.

• В папке legacy/ содержатся два оригинальных скрипта (akahu.py, list_accounts.py), из которых вырос этот проект. Они по-прежнему работают автономно — установите их зависимости с помощью uv sync --group legacy, затем используйте uv run --group legacy python legacy/list_accounts.py.