MCP-сервер для отслеживания расходов

MCP-сервер (Model Context Protocol), который позволяет ИИ-ассистентам, таким как Claude, управлять личными расходами — добавлять, классифицировать, суммировать и планировать бюджет — с использованием локальной базы данных SQLite.

Обзор

Этот сервер предоставляет набор инструментов MCP, которые Claude (или любой другой MCP-совместимый клиент) может вызывать для отслеживания ваших трат. Все данные хранятся локально в файле SQLite — никакого облака или учетных записей не требуется.

Возможности

Добавление и управление расходами с указанием категорий, сумм, дат и описаний
Фильтрация и просмотр списка расходов по диапазону дат или категории
Суммирование расходов по категориям или месяцам
Установка бюджетов для каждой категории и проверка остатка средств
Экспорт расходов в CSV
Полная локальность — данные остаются на вашем компьютере

Инструменты MCP

Инструмент	Описание	Ключевые параметры
`add_expense`	Записать новый расход	`amount`, `category`, `description`, `date`, `currency`
`list_expenses`	Список расходов с дополнительными фильтрами	`category?`, `start_date?`, `end_date?`, `limit?`
`get_expense_summary`	Агрегированные итоги, сгруппированные по категории или месяцу	`group_by` (`category` или `month`), `start_date?`, `end_date?`
`update_expense`	Редактировать существующий расход по ID	`id`, `amount?`, `category?`, `description?`, `date?`
`delete_expense`	Удалить расход по ID	`id`
`set_budget`	Установить ежемесячный лимит бюджета для категории	`category`, `monthly_limit`, `currency?`
`get_budget_status`	Сравнение лимитов бюджета с фактическими тратами	`month?` (по умолчанию текущий месяц)
`export_expenses`	Экспорт расходов в виде CSV-строки	`start_date?`, `end_date?`, `category?`

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

expense-tracker-mcp-server/
├── main.py             # MCP server entry point (all tools)
├── expenses.db         # SQLite database (auto-created on first run)
├── pyproject.toml      # Project metadata and dependencies
├── .venv/              # Virtual environment (created by uv)
└── readme.md

Предварительные требования

Python 3.11+
uv (рекомендуется) или pip
Claude Desktop (для подключения MCP-сервера)

Установка

# Clone the repo
git clone https://github.com/your-username/expense-tracker-mcp-server.git
cd expense-tracker-mcp-server

# Initialize the project and install dependencies
uv init
uv add fastmcp

Это автоматически создаст папку .venv внутри директории проекта.

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

fastmcp run main.py

Сервер запускается и ожидает MCP-соединения через stdio. База данных SQLite (expenses.db) создается автоматически при первом запуске.

Подключение к Claude Desktop

Добавьте следующее в ваш файл конфигурации Claude Desktop:

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

{
  "mcpServers": {
    "expense-tracker": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\Learning\\Expense-Tracker-MCP-Server",
        "run",
        "fastmcp",
        "run",
        "main.py"
      ]
    }
  }
}

Полностью закройте Claude Desktop (системный трей → Quit) и откройте его снова. Вы должны увидеть инструменты отслеживания расходов на панели инструментов.

Примеры запросов

После подключения к Claude вы можете сказать:

"Добавь расход $45 на продукты в Whole Foods сегодня"
"Покажи мне все расходы на еду за этот месяц"
"На что я потратил больше всего в прошлом месяце?"
"Установи ежемесячный бюджет $300 на рестораны"
"Сколько осталось от моего бюджета на развлечения?"
"Экспортируй все мои расходы за март в CSV"

Разработка

# Run with MCP inspector for debugging
fastmcp dev inspector main.py

Лицензия

MIT

Expense Tracker MCP Server