Skip to main content
Glama
deenesjakoruzh
deepakbishnoi717

Expense Tracker MCP Server

by deepakbishnoi717
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

Тестовый удаленный MCP-сервер — Отслеживание расходов

Удаленный сервер на базе FastMCP для управления расходами с поддержкой категорий и детальным отслеживанием.

Обзор

Этот проект предоставляет реализацию протокола Model Context Protocol (MCP) для службы отслеживания расходов. Он использует FastMCP для предоставления инструментов управления расходами, которые можно интегрировать с Claude Desktop или другими MCP-совместимыми клиентами.

Related MCP server: Expense Tracker MCP Server

Функции

  • Добавление расходов: Регистрация новых записей о расходах с датой, суммой, категорией и примечаниями

  • Поддержка категорий: Организация расходов по категориям и подкатегориям

  • Постоянное хранение данных: База данных SQLite для надежного хранения информации

  • Асинхронные операции: Построено с использованием async/await для эффективных параллельных операций

  • Прокси-сервер: Включает конфигурацию прокси-сервера для удаленного доступа

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

test-remote-mcp-server/
├── main.py              # Main FastMCP server with expense tracking tools
├── proxy.py             # Proxy configuration for remote server access
├── categories.json      # Category definitions for expenses
├── pyproject.toml       # Project configuration and dependencies
└── README.md            # This file

Установка

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

  • Python 3.11 или выше

  • Менеджер пакетов pip или Poetry

Настройка

  1. Клонируйте репозиторий:

git clone https://github.com/deepakbishnoi717/test-remote-mcp-server.git
cd test-remote-mcp-server

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

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

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

pip install -e .

Или с помощью Poetry:

poetry install

Использование

Запуск локального сервера

Запустите локальный сервер FastMCP:

python main.py

Использование прокси-сервера

Для запуска прокси-сервера, который подключается к удаленному экземпляру FastMCP Cloud:

python proxy.py

Доступные инструменты

add_expense

Добавление новой записи о расходе в базу данных.

Параметры:

  • date (строка): Дата расхода (например, "2024-01-15")

  • amount (число с плавающей точкой): Потраченная сумма

  • category (строка): Основная категория расхода

  • subcategory (строка, необязательно): Подкатегория расхода

  • note (строка, необязательно): Дополнительные примечания о расходе

Пример:

await add_expense("2024-01-15", 25.50, "Food", "Groceries", "Weekly shopping")

База данных

Проект использует SQLite для хранения данных. База данных автоматически инициализируется при первом запуске и включает:

  • Автоматическое создание таблиц

  • WAL (Write-Ahead Logging) для лучшей параллельной работы

  • Таблицу категорий для организации расходов

Расположение файла базы данных: системная временная директория (expenses.db)

Технологический стек

  • FastMCP: Фреймворк протокола Model Context Protocol

  • aiosqlite: Асинхронный драйвер SQLite

  • Python 3.11+: Современный Python с поддержкой асинхронности

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

Категории

Категории расходов определены в файле categories.json. Настройте этот файл, чтобы добавить или изменить категории расходов для вашего случая использования.

Интеграция с Claude Desktop

Чтобы использовать этот сервер с Claude Desktop:

  1. Настройте сервер, следуя инструкциям по установке выше

  2. Настройте Claude Desktop для подключения к этому MCP-серверу

  3. Используйте запросы на естественном языке для управления своими расходами

Лицензия

Этот проект является открытым исходным кодом и доступен по соответствующей лицензии.

Участие в разработке

Вклад приветствуется! Пожалуйста, не стесняйтесь отправлять pull-запросы или открывать задачи (issues).

Поддержка

По вопросам или проблемам, пожалуйста, откройте задачу на GitHub по адресу: https://github.com/deepakbishnoi717/test-remote-mcp-server/issues

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Expense Tracker MCP Server

    Dhruta25
    F
    license
    Not graded
    quality
    D
    maintenance
    Enables users to track and manage daily expenses through SQLite storage, supporting operations like adding, updating, deleting expenses, calculating totals by category, and filtering expenses by date range or category.
    -

  • Expense Tracker MCP Server

    Sudhanvaha
    F
    license
    C
    quality
    D
    maintenance
    Enables personal expense management with SQLite storage, allowing users to add, update, delete, list, and summarize expenses by category through natural language interactions.
    5
    -

  • Expense Tracker MCP Server

    PK-SANGAMESWAR
    F
    license
    A
    quality
    D
    maintenance
    Enables tracking and managing personal expenses through a local SQLite database. Supports adding, editing, deleting, listing, and summarizing expenses by category, as well as managing credit accounts.
    6
    -

  • Expense Tracker MCP

    AKSHAYBITLINGU
    F
    license
    B
    quality
    D
    maintenance
    Tracks and manages personal expenses with tools to add, view, filter by category, and summarize spending over date ranges using SQLite storage.
    4
    -