Expense Tracker MCP

FastMCP で構築されたリモートの Model Context Protocol (MCP) サーバーです。Claude などの AI アシスタントが、構造化されたツールを介して経費追跡システムを操作できるようにします。

Module Overview

このプロジェクトは、AI アシスタントが MCP を通じて外部データやアプリケーション機能と対話できることを示しています。

Expense Tracker MCP 서버ーは、FastMCP を使用して経費管理ツールを公開し、SQLite を使用して経費データを保存します。

The server is deployed remotely using FastMCP Cloud, allowing an MCP-compatible client such as Claude to connect to it through a remote MCP endpoint.

Related MCP server: Expense Tracker MCP

Architechture

Claude
   │
   │ MCP
   ▼
Remote MCP Endpoint
   │
   ▼
FastMCP Cloud
   │
   ▼
FastMCP Expense Tracker Server
   │
   ▼
SQLite Database

✨ Features

• 経費の追加と管理

• 経費記録の取得

• 経費のカテゴリ分類

• SQLite を使用した経費データの保存

• MCP ツールによる経費機能の公開

• MCP サーバューバのリモートデプロイ

• リモートのMCP サーバューバのClaude への接続

• AI アシスタントが構造化された経費データを操作できるようにする

️ Tech Stack

• Python

• FastMCP

• Model Context Protocol (MCP)

• SQLite

• JSON

• FastMCP Cloud

• Claude

🔌 対話例

Claude に接続すると、ユーザーは自然言語で経費トラッカーと操作できます。

"Add an expense of ₹500 for groceries."

"Show me my recent expenses."

"How much did I spend on food?"

"List my expenses by category."

Claude はユーザーの要求を解釈し、サーバーバーが公開する適切な MCP ツールを呼び出します。

☁️ リモートデプロイ

MCP サーバーバーは FastMCP Cloud にデプロイされ、リモート MCP エンドポイントを介して公開されます。

これにより、Claude やその他のMCP 対応クライアントは、サーバーバーをロカルで実行することなくサーバーにアクセスできます。

Local Development
       ↓
FastMCP Server
       ↓
FastMCP Cloud
       ↓
Remote MCP Endpoint
       ↓
Claude

⚙️ ローカルセットアップ

リポジトリをクローンします:

git clone https://github.com/khushisonwane23/expense-tracker-mcp.git
cd expense-tracker-mcp

仮想環境を作成します:

python -m venv .venv

仮想環境を Windows で有効化します:

.venv\Scripts\activate

依存関係をインストールします:

pip install -r requirements.txt

uv を使用している場合:

uv sync

▶️ ローカルでの実

FastMCP サーバーバーを実执行します:

fastmcp run server.py

正しいコマンドは、プロジェクトの構築によって異なることがあります。

o Connecting to Claude

サーバーバーを FastMCP Cloud にデプロイすると、アプリーはリモート MCP エンドポイントを提供します。

このエンドポイントは、Claude などの MCP 対応クライアントで設定できます。

Claude
   ↓
Remote MCP Endpoint
   ↓
FastMCP Cloud
   ↓
Expense Tracker MCP Server
   ↓
SQLite Database

接続すると、Claude は MCP サーババーが公開するツールを発見して使用できます。

🔐 セキュリティ

機微情報をこのリポジトリーにコミットしてはなないでください。

以下のファイルは非公開のままにしてください：

.env
expenses.db
.venv/
__pycache__/

API キーやその他のシークレットは、ソースコードにハードコーダで記録するのではなく、環境変数を使って保存する必要があります。

🧮 学習目標

このプロジェクトは、次のことを理解するために作られました。

• Model Context Protocol がどのように働くか

• AI アシスタントが外部のツールとどのように対話するか

• FastMCP を使って MCP サーバーを構築する方法

• LLM を外部データに接続する方法

• ツールベースの AI ワークフローがどのように機能するか

• MCP サーバーをリモートでデプロイする方法

• MCP を Claude に統合する方法

🚧 将来の改善点

• 認証と認可の追加

• 月間の支出分析の追加

• 予算の追跡の追加

• より豊かな財務インサイトの追加

• エラー処理と入力検証の改善

• 自動テストの追加

• 本番環境が見に使用できるデータベースの使用

• 他財務管理ツールの追加

👩💻 Author

Khushi Sonwane

気になるのこと。