Skip to main content
Glama
deepakbishnoi717

Expense Tracker MCP Server

Test Remote MCP Server - Expense Tracker

カテゴリサポートと詳細な追跡機能を備えた、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 (string): 経費の日付 (例: "2024-01-15")

  • amount (float): 支出金額

  • category (string): 主な経費カテゴリ

  • subcategory (string, optional): 経費のサブカテゴリ

  • note (string, optional): 経費に関する追加メモ

例:

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. このMCPサーバーに接続するようにClaude Desktopを設定します

  3. 自然言語クエリを使用して経費を管理します

ライセンス

このプロジェクトはオープンソースであり、適切なライセンスの下で利用可能です。

コントリビューション

コントリビューションを歓迎します!プルリクエストの送信やIssueの作成を自由に行ってください。

サポート

問題や質問がある場合は、GitHubでIssueを作成してください: https://github.com/deepakbishnoi717/test-remote-mcp-server/issues

Related MCP Connectors

Related MCP Servers

  • 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.
    -
  • 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
    -
  • 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
    -
  • 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
    -