Для чего этот сервер?

Сервер подключает AI-ассистентов к бухгалтерской системе HLedger. Теперь можно просто спросить чат-бота о балансе счетов, доходах или расходах, построить отчёт или добавить новую проводку — без ручного запуска команд. Это упрощает работу с финансами для тех, кто ведёт учёт в HLedger, но хочет управлять данными через естественный диалог.

Каталог MCP
@iiatlas/hledger-mcp

@iiatlas/hledger-mcp

от iiatlas

MCP-сервер для интеграции AI-ассистентов с бухгалтерской системой hledger. Позволяет запрашивать балансы, формировать отчёты (баланс, P&L, cash flow), добавлять проводки и анализировать данные чере...

Github NPM Сайт сервера

README

Инструменты и схема сервера

Версии

Установить сервер

HLedger MCP Server

A Model Context Protocol (MCP) server that provides AI assistants (MCP Clients) with direct access to HLedger accounting data and functionality. This server enables AI applications to query account balances, generate financial reports, add new entires, and analyze accounting data through a standardized protocol.

It has support for most hledger cli commands, the ability to fetch an traverse include'd journal files, and a safe --read-only mode. I hope you find it useful!

Published on npm as @iiatlas/hledger-mcp, and available as an installable .mcpb file from releases.

GitHub License GitHub Release

Features

The HLedger MCP server provides comprehensive access to HLedger's financial reporting capabilities through the following tools:

Core Accounting

Accounts - List and query account names and structures
Balance - Generate balance reports with extensive customization options
Register - View transaction registers and posting details
Print - Output journal entries and transactions

Financial Reports

Balance Sheet - Generate balance sheet reports
Balance Sheet Equity - Balance sheet reports with equity details
Income Statement - Profit & loss statements
Cash Flow - Cash flow analysis and reports

Часто задаваемые вопросы

У этого сервера пока нет списка инструментов.

`1.0.5`основная	25.09.2025
`1.0.4`	24.09.2025
`1.0.3`	24.09.2025
`1.0.2`	23.09.2025
`1.0.1`	23.09.2025
`1.0.0`	23.09.2025

Выберите клиент, чтобы установить @iiatlas/hledger-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "iiatlas-hledger-mcp-2f103w5ovo": {
      "command": "npx",
      "args": [
        "-y",
        "@iiatlas/hledger-mcp",
        "/path/to/your/master.journal"
      ]
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "iiatlas-hledger-mcp-2f103w5ovo": {
      "command": "npx",
      "args": [
        "-y",
        "@iiatlas/hledger-mcp",
        "/path/to/your/master.journal"
      ]
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "iiatlas-hledger-mcp-2f103w5ovo": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@iiatlas/hledger-mcp",
        "/path/to/your/master.journal"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"iiatlas-hledger-mcp-2f103w5ovo\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"@iiatlas/hledger-mcp\",\"/path/to/your/master.journal\"]}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "iiatlas-hledger-mcp-2f103w5ovo": {
      "command": "npx",
      "args": [
        "-y",
        "@iiatlas/hledger-mcp",
        "/path/to/your/master.journal"
      ]
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add iiatlas-hledger-mcp-2f103w5ovo -- npx -y @iiatlas/hledger-mcp /path/to/your/master.journal

Либо через JSON-конфиг:

claude mcp add-json iiatlas-hledger-mcp-2f103w5ovo "{\"command\":\"npx\",\"args\":[\"-y\",\"@iiatlas/hledger-mcp\",\"/path/to/your/master.journal\"]}"

Codex

Добавьте сервер командой в терминале:

codex mcp add iiatlas-hledger-mcp-2f103w5ovo -- npx -y @iiatlas/hledger-mcp /path/to/your/master.journal

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.iiatlas-hledger-mcp-2f103w5ovo]
command = "npx"
args = ["-y", "@iiatlas/hledger-mcp", "/path/to/your/master.journal"]

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите @iiatlas/hledger-mcp, а в поле команды запуска — строку ниже:

npx -y @iiatlas/hledger-mcp /path/to/your/master.journal

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "iiatlas-hledger-mcp-2f103w5ovo": {
      "command": "npx",
      "args": [
        "-y",
        "@iiatlas/hledger-mcp",
        "/path/to/your/master.journal"
      ]
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "iiatlas-hledger-mcp-2f103w5ovo": {
      "command": "npx",
      "args": [
        "-y",
        "@iiatlas/hledger-mcp",
        "/path/to/your/master.journal"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например iiatlas-hledger-mcp-2f103w5ovo.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: iiatlas-hledger-mcp-2f103w5ovo
    command: npx
    args:
      - "-y"
      - "@iiatlas/hledger-mcp"
      - "/path/to/your/master.journal"

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "iiatlas-hledger-mcp-2f103w5ovo": {
      "command": "npx",
      "args": [
        "-y",
        "@iiatlas/hledger-mcp",
        "/path/to/your/master.journal"
      ]
    }
  }
}

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "@iiatlas/hledger-mcp",
    "/path/to/your/master.journal"
  ]
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

Информация о сервере

Номер в рейтинге: #191
Звезд на Github: 65
Форков на Github: 5
Загрузок: 834
Язык реализации: TypeScript
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 19.10 в 07:32
Идентификатор: CSpCZrkhmj7l3FwS
Категории: Финансы

Похожие MCP-сервера

CCXT MCP

от lazy-dinosaur

MCP сервер на базе CCXT позволяет AI-моделям торговать на 100+ криптобиржах, получать рыночные данные и анализировать эффективность. Поддерживает ордера, баланс и управление рисками. Идеален для автоматизации.

PaulieB14/graph-polymarket-mcp

от paulieb14

MCP сервер для запроса данных рынка предсказаний Polymarket через The Graph и REST API. Дает AI агентам 31 инструмент: поиск рынков, цены, стаканы, P&L, open interest и статусы разрешения. Часть да...

financial-datasets/mcp-server

от financial-datasets

MCP сервер для доступа к финансовым данным из Financial Datasets. Предоставляет отчёты о прибылях, балансы, цены акций и криптовалют через интерфейс ИИ-ассистентов. Полезен для инвесторов и аналитиков.

Bitget-AI/agent-mcp

от bitget-ai

MCP сервер для криптотрейдинга на Bitget через ИИ-агентов. Позволяет торговать, управлять балансом, кредитами и налогами на естественном языке в Claude, Cursor, ChatGPT. 14 команд покрывают 89 операций — без лишних инструментов.

michalperni11-gif/secfinapi-mcp

от michalperni11-gif

MCP-сервер для доступа к стандартизированным финансовым данным SEC EDGAR через SECfinAPI. Предоставляет полные финансовые отчеты и 40+ коэффициентов как инструменты для AI-ассистентов. Работает лок...

kukapay/polymarket-predictions-mcp

от kukapay

С MCP-сервером вы получаете реальные рыночные шансы Polymarket. AI-агенты и аналитики могут искать события, сравнивать вероятности и анализировать децентрализованные предсказания – всё в чистых таб...