Expense Tracker MCP Server

Локальный сервер Model Context Protocol (MCP) для персонального трекера расходов, написанный на Python и SQLite3.

Возможности

• add_expense — добавить расход; уменьшает доступный кредит

• list_expenses — список расходов (сначала новые), опционально фильтруется по категории

• summarize_expenses — итоги по категориям, количество, добавленный кредит и доступный кредит

• edit_expense — редактировать расход; корректирует кредит на разницу в сумме

• delete_expense — удалить расход; возвращает сумму в кредит

• add_credit — добавить кредит к доступному балансу

Все операции, изменяющие баланс, выполняются внутри транзакций SQLite.

Related MCP server: Expense Tracker MCP Server

Структура папок

local MCP server/
├── main.py                       # MCP server + tool definitions (entry point)
├── expense_tracker/
│   ├── __init__.py
│   ├── database.py               # SQLite connection + schema setup
│   └── operations.py             # Core expense/credit business logic
├── pyproject.toml                # Project config (fastmcp dependency)
├── uv.lock                       # Lockfile
└── README.md

Файл базы данных expense_tracker.db создается автоматически при первом вызове инструмента.

Установка

Склонируйте репозиторий:

git clone https://github.com/YogeshSharma2007/Local-Expense-tracker-MCP.git
cd Local-Expense-tracker-MCP

Создайте и активируйте виртуальное окружение:

python -m venv .venv
.\.venv\Scripts\Activate.ps1

Установите зависимости:

uv sync          # or: pip install -e .

Запуск сервера

python main.py

Затем зарегистрируйте сервер как локальный MCP stdio-сервер в вашем MCP-клиенте.

Регистрация в MCP-клиенте (пример для OpenCode)

Добавьте в вашу конфигурацию OpenCode (opencode.json или туда, где находится конфигурация вашего клиента):

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "local-mcp": {
      "type": "local",
      "command": [
        "<path-to-repo>\\.venv\\Scripts\\python.exe",
        "<path-to-repo>\\main.py"
      ],
      "enabled": true
    }
  }
}

Замените <path-to-repo> на полный путь к тому месту, куда вы склонировали этот репозиторий, например:

C:\Users\<your-username>\Documents\Local-Expense-tracker-MCP

Конфигурация

Путь к базе данных по умолчанию — expense_tracker.db в папке проекта. Переопределите его с помощью переменной окружения:

$env:EXPENSE_TRACKER_DB = "C:\path\to\expense_tracker.db"

We need to ensure we preserve the exact structure: headings, bullet points, code blocks, placeholders. We have done that.

Now double-check: The instructions say "Translate prose only." So we did. We kept all code spans, placeholders, and the raw HTML? There is no raw HTML. We kept the structure.

We need to output only the translated text, no wrapper. No commentary.

Let's produce the final translation.# Expense Tracker MCP Server

Локальный сервер Model Context Protocol (MCP) для персонального трекера расходов, написанный на Python и SQLite3.

Возможности

• add_expense — добавить расход; уменьшает доступный кредит

• list_expenses — список расходов (сначала новые), опционально фильтруется по категории

• summarize_expenses — итоги по категориям, количеству, добавленному кредиту и доступному кредиту

• edit_expense — редактирование расхода; корректирует кредит на разницу в сумме

• delete_expense — удаление расхода; возвращает сумму в кредит

• add_credit — добавить кредит к доступному балансу

Все операции, изменяющие баланс, выполняются внутри транзакций SQLite.

Структура папок

local MCP server/
├── main.py                       # MCP server + tool definitions (entry point)
├── expense_tracker/
│   ├── __init__.py
│   ├── database.py               # SQLite connection + schema setup
│   └── operations.py             # Core expense/credit business logic
├── pyproject.toml                # Project config (fastmcp dependency)
├── uv.lock                       # Lockfile
└── README.md

Файл базы данных expense_tracker.db создается автоматически при первом вызове инструмента.

Установка

Склонируйте репозиторий:

git clone https://github.com/YogeshSharma2007/Local-Expense-tracker-MCP.git
cd Local-Expense-tracker-MCP

Создайте и активируйте виртуальное окружение:

python -m venv .venv
.\.venv\Scripts\Activate.ps1

Установите зависимости:

uv sync          # or: pip install -e .

Запуск сервера

python main.py

Затем зарегистрируйте сервер как локальный MCP stdio-сервер в вашем MCP-клиенте.

Регистрация в MCP-клиенте (пример для OpenCode)

Добавьте в вашу конфигурацию OpenCode (opencode.json или туда, где находится конфигурация вашего клиента):

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "local-mcp": {
      "type": "local",
      "command": [
        "<path-to-repo>\\.venv\\Scripts\\python.exe",
        "<path-to-repo>\\main.py"
      ],
      "enabled": true
    }
  }
}

Замените <path-to-repo> на полный путь к тому месту, куда вы склонировали этот репозиторий, например:

C:\Users\<your-username>\Documents\Local-Expense-tracker-MCP

Конфигурация

Путь к базе данных по умолчанию — expense_tracker.db в папке проекта. Переопределите его с помощью переменной окружения:

$env:EXPENSE_TRACKER_DB = "C:\path\to\expense_tracker.db"